DOC: document where to touch to bump numpy/Python version

tacaswell · dstansby · QuLogic · tacaswell · commit 4c435a69160d · 2025-04-17T15:01:30.000-04:00
Co-authored-by: David Stansby &lt;dstansby@gmail.com&gt;
Co-authored-by: Elliott Sales de Andrade &lt;quantum.analyst@gmail.com&gt;
diff --git a/doc/devel/min_dep_policy.rst b/doc/devel/min_dep_policy.rst
@@ -155,3 +155,50 @@ Matplotlib  Python    NumPy
 .. _`1.5`: https://matplotlib.org/1.5.0/users/installing.html#required-dependencies
 .. _`1.4`: https://matplotlib.org/1.4.0/users/installing.html#required-dependencies
 .. _`1.3`: https://matplotlib.org/1.3.0/users/installing.html#build-requirements
+
+
+Updating Python and NumPy versions
+==================================
+
+To update the minimum versions of Python we need to update:
+
+- ``pyproject.toml`` (classifiers, requires-python, ``[ruff.tool]`` target-version)
+- ``environment.yml``
+- ``doc/install/dependencies.rst``
+- ``doc/devel/min_dep_policy.rst`` (this file)
+- CI configuration files (circle, GHA, azure)
+- ``tox.ini``
+
+To update the minimum NumPy we need to update:
+
+- ``pyproject.toml``
+- ``environment.yml``
+- ``doc/install/dependencies.rst``
+- ``doc/devel/min_dep_policy.rst`` (this file)
+- ``requirements/testing/minver.txt``
+- ``lib/matplotlib/__init__.py`` (matplotlib._check_versions())
+
+
+The work to leverage new features or remove workarounds for no-longer supported
+versions should be done in a follow-on PRs to keep the version bump PRs well
+scoped.
+
+In both cases add an api_changes/development with the following template:
+
+.. code-block:: rst
+
+   Increase to minimum supported versions of dependencies
+   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+   For Matplotlib 3.ZZ, the :ref:`minimum supported versions <dependencies>` are
+   being bumped:
+
+   +------------+-----------------+----------------+
+   | Dependency |  min in mpl3.N  | min in mpl3.M  |
+   +============+=================+================+
+   |   Python   |       3.XX      |       3.AA     |
+   |   NumPy    |       1.YY      |       1.BB     |
+   +------------+-----------------+----------------+
+
+   This is consistent with our :ref:`min_deps_policy` and `SPEC0
+   <https://scientific-python.org/specs/spec-0000/>`__
