Add note

dstansby · dstansby · commit d45f9d43cd15 · 2018-07-12T09:09:19.000-07:00
diff --git a/doc/api/api_changes.rst b/doc/api/api_changes.rst
@@ -17,7 +17,14 @@ This pages lists API changes for the most recent version of Matplotlib.
 
    api_changes_old
 
-.. for a release comment out the toctree below
+.. note::
+
+  The list below is a table of contents of individual files from the 'next_api_changes' folder.
+  When a release is made
+
+    - The full text list below should be moved into its own file in 'prev_api_changes'
+    - All the files in 'next_api_changes' should be moved to the bottom of this page
+    - This note, and the toctree below should be commented out
 
 
 .. toctree::
