diff --git a/docs/content/guide/directive.ngdoc b/docs/content/guide/directive.ngdoc
index 77c558aaca9e..691d609d8c45 100644
--- a/docs/content/guide/directive.ngdoc
+++ b/docs/content/guide/directive.ngdoc
@@ -867,6 +867,7 @@ element?
   </file>
 </example>
 
+Note: Returning a `function(scope, element, attr){...}` is just a shorthand for `{link: function(scope, element, attr){...}}`.
 
 
 ### Creating Directives that Communicate