Release note for #1161

CHANGELOG.txt

@@ -44,6 +44,7 @@ Changelog
  * Added "Add child page" button to admin userbar (Eric Drechsel)
  * Renamed the `construct_wagtail_edit_bird` hook to `construct_wagtail_userbar`
  * 'static' template tags are now used throughout the admin templates, in place of STATIC_URL
+ * Added a new decorator-based syntax for RoutablePage, compatible with Django 1.8
 
 
 0.8.7 (xx.xx.2015)

docs/releases/1.0.rst

@@ -106,6 +106,12 @@ Search
  * Search view accepts "page" GET parameter in line with pagination
 
 
+Routable pages
+--------------
+
+ * Added a new decorator-based syntax for RoutablePage, compatible with Django 1.8
+
+
 Bug fixes
 ~~~~~~~~~
 
@@ -195,6 +201,13 @@ It is no longer necessary to pass the base model as a parameter, so this declara
 
 The old format is now deprecated; all existing ``InlinePanel`` declarations should be updated to the new format.
 
+``RoutablePage`` now uses decorator syntax for defining views
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+In previous versions of Wagtail, ``RoutablePage`` models were configured by setting a ``subpage_urls`` attribute within the page model. This fails in Django 1.8, because it relies on passing the view function name as a string which is not an absolute module path. To address this, Wagtail 1.0 introduces a new syntax where each view function is annotated with a ``@route`` decorator - see :ref:`routable_page_mixin`.
+
+The old ``subpage_urls`` convention will continue to work on Django versions prior to 1.8, but this is now deprecated; all existing ``RoutablePage`` definitions should be updated to the decorator-based convention.
+
 Celery no longer automatically used for sending notification emails
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~