Consolidate development API changes for 3.6

tacaswell · Sep 15, 2022 · Aug 24, 2022 · Sep 3, 2022 · Sep 3, 2022 · Sep 7, 2022
commit e885917a4af3e1c4f4005d5b5648b4f564bb438a
diff --git a/doc/api/next_api_changes/development/21415-AL.rst b/doc/api/next_api_changes/development/21415-AL.rst
diff --git a/doc/api/next_api_changes/development/22205-ES.rst b/doc/api/next_api_changes/development/22205-ES.rst
diff --git a/doc/api/next_api_changes/development/22550-AL.rst b/doc/api/next_api_changes/development/22550-AL.rst
diff --git a/doc/api/prev_api_changes/api_changes_3.6.0.rst b/doc/api/prev_api_changes/api_changes_3.6.0.rst
@@ -0,0 +1,8 @@
+API Changes for 3.6.0
+=====================
+
+.. contents::
+   :local:
+   :depth: 1
+
+.. include:: /api/prev_api_changes/api_changes_3.6.0/development.rst
diff --git a/doc/api/prev_api_changes/api_changes_3.6.0/development.rst b/doc/api/prev_api_changes/api_changes_3.6.0/development.rst
@@ -0,0 +1,42 @@
+Development changes
+-------------------
+
+Increase to minimum supported versions of dependencies
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+For Matplotlib 3.6, the :ref:`minimum supported versions <dependencies>` are
+being bumped:
+
++------------+-----------------+---------------+
+| Dependency |  min in mpl3.5  | min in mpl3.6 |
++============+=================+===============+
+|   Python   |       3.7       |      3.8      |
++------------+-----------------+---------------+
+|   NumPy    |       1.17      |      1.19     |
++------------+-----------------+---------------+
+
+This is consistent with our :ref:`min_deps_policy` and `NEP29
+<https://numpy.org/neps/nep-0029-deprecation_policy.html>`__
+
+Build setup options changes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The ``gui_support.macosx`` setup option has been renamed to
+``packages.macosx``.
+
+New wheel architectures
+~~~~~~~~~~~~~~~~~~~~~~~
+
+Wheels have been added for:
+
+- Python 3.11
+- PyPy 3.8 and 3.9
+
+Increase to required versions of documentation dependencies
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+`sphinx`_ >= 3.0 and `numpydoc`_ >= 1.0 are now required for building the
+documentation.
+
+.. _numpydoc: https://pypi.org/project/numpydoc/
+.. _sphinx: https://pypi.org/project/Sphinx/
diff --git a/doc/users/release_notes.rst b/doc/users/release_notes.rst
@@ -9,6 +9,14 @@ Release notes
 .. include from another document so that it's easy to exclude this for releases
 .. include:: release_notes_next.rst
 
+Version 3.6
+===========
+.. toctree::
+    :maxdepth: 1
+
+    ../api/prev_api_changes/api_changes_3.6.0.rst
+    github_stats.rst
+
 Version 3.5
 ===========
 .. toctree::