Improvements to subpage_urls docs

docs/routable_page.rst

@@ -53,9 +53,18 @@ The ``RoutablePage`` class
 .. automodule:: wagtail.contrib.wagtailroutablepage.models
 .. autoclass:: RoutablePage
 
-    .. attribute:: subpage_urls
+    .. autoattribute:: subpage_urls
 
-        Set this to a tuple of ``django.conf.urls.url`` objects.
+        Example:
+
+        .. code-block:: python
+
+            from django.conf.urls import url
+
+            subpage_urls = (
+                url(r'^$', 'serve', name='main'),
+                url(r'^archive/$', 'archive', name='archive'),
+            )
 
     .. automethod:: resolve_subpage
 

wagtail/contrib/wagtailroutablepage/models.py

@@ -12,6 +12,7 @@ class RoutablePage(Page):
     """
     This class extends Page by adding methods to allow urlconfs to be embedded inside pages
     """
+    #: Set this to a tuple of ``django.conf.urls.url`` objects.
     subpage_urls = None
 
     def reverse_subpage(self, name, args=None, kwargs=None):