Merge pull request #28628 from timhoffm/doc-api-changes

QuLogic · web-flow · commit 08759eabcd40 · 2024-07-30T18:12:07.000-04:00
DOC: Sub-structure next API changes overview
diff --git a/doc/api/next_api_changes.rst b/doc/api/next_api_changes.rst
@@ -5,11 +5,40 @@ Next API changes
 
 .. ifconfig:: releaselevel == 'dev'
 
+   This page lists API changes for the next release.
+
+   Behavior changes
+   ----------------
+
    .. toctree::
       :glob:
       :maxdepth: 1
 
       next_api_changes/behavior/*
+
+   Deprecations
+   ------------
+
+   .. toctree::
+      :glob:
+      :maxdepth: 1
+
       next_api_changes/deprecations/*
-      next_api_changes/development/*
+
+   Removals
+   --------
+
+   .. toctree::
+      :glob:
+      :maxdepth: 1
+
       next_api_changes/removals/*
+
+   Development changes
+   -------------------
+
+   .. toctree::
+      :glob:
+      :maxdepth: 1
+
+      next_api_changes/development/*
