Put “Important compatibility changes” at the top of CHANGES.txt

Signed-off-by: Chris Warrick <kwpolska@gmail.com>
getnikola · Apr 26, 2018 · 5c7de24 · 5c7de24
1 parent f6eb249
commit 5c7de24
Showing 1 changed file with 12 additions and 8 deletions.
diff --git a/CHANGES.txt b/CHANGES.txt
@@ -1,6 +1,18 @@
 New in master
 =============
 
+Important compatibility changes
+-------------------------------
+
+* Rename ``crumbs.tmpl`` to ``ui_helper.tmpl`` and the breadcrumbs
+  ``bar`` function to ``breadcrumbs`` (your templates may need
+  changing as well)
+* Reading reST docinfo metadata, including first heading as title,
+  requires ``USE_REST_DOCINFO_METADATA`` now (Issue #2987)
+* RSS feeds might have changed their places due to ``RSS_PATH``
+  behavior changes (you may need to change ``RSS_PATH``,
+  ``RSS_FILENAME_BASE``)
+
 Features
 --------
 
@@ -126,14 +138,6 @@ Removed features
   (Issue #2785)
 * Removed old 7-line metadata format (Issue #2839)
 
-Other changes
--------------
-
-* Rename ``crumbs.tmpl`` to ``ui_helper.tmpl`` and the breadcrumbs
-  ``bar`` function to ``breadcrumbs``
-* Reading reST docinfo metadata, including first heading as title,
-  requires ``USE_REST_DOCINFO_METADATA`` now (Issue #2987)
-
 New in v7.8.8
 =============