diff --git a/docs/ref/contrib/syndication.txt b/docs/ref/contrib/syndication.txt
index 9a0aa9b..b1f2378 100644
--- a/docs/ref/contrib/syndication.txt
+++ b/docs/ref/contrib/syndication.txt
@@ -388,11 +388,28 @@ This example illustrates all possible attributes and methods for a
 
         def link(self, obj):
             """
+            # Takes the object returned by get_object() and returns the link
+            # to the HTML version of the feed as a normal Python string.
+            """
+
+        def link(self):
+            """
+            Returns the link to the HTML version of the feed as a normal Python
+            string.
+            """
+
+        link = '/foo/bar/' # Hard-coded link.
+
+        # FEED_URL -- One of the following three is optional. The framework
+        # looks for them in this order.
+
+        def feed_url(self, obj):
+            """
             # Takes the object returned by get_object() and returns the feed's
             # link as a normal Python string.
             """
 
-        def link(self):
+        def feed_url(self):
             """
             Returns the feed's link as a normal Python string.
             """