diff --git a/doc/devel/min_dep_policy.rst b/doc/devel/min_dep_policy.rst index d9233d5c527e..390f6c5bc496 100644 --- a/doc/devel/min_dep_policy.rst +++ b/doc/devel/min_dep_policy.rst @@ -9,18 +9,29 @@ SemVer (major, minor, patch) and includes both major and minor releases. For projects that use date-based versioning, every release is a 'minor version'. +Matplotlib follows `NEP 29 +`__. + Python and NumPy ================ -- support minor versions of ``Python`` initially released - 36 months prior to our planned release date. -- support minor versions of ``numpy`` initially released in the 36 - months prior to our planned release date or oldest that supports the - minimum python version (which ever is higher) +Matplotlib supports: + + +- All minor versions of Python released 42 months prior to the + project, and at minimum the two latest minor versions. +- All minor versions of ``numpy`` released in the 24 months prior + to the project, and at minimum the last three minor versions. + +In ``setup.py``, the ``python_requires`` variable should be set to +the minimum supported version of Python. All supported minor +versions of Python should be in the test matrix and have binary +artifacts built for the release. + +Minimum Python and NumPy version support should be adjusted upward +on every major and minor release, but never on a patch release. -We will bump the minimum python and numpy versions as we can every -minor and major release, but never on a patch release. See also the :ref:`list-of-dependency-min-versions`. @@ -30,12 +41,12 @@ Python Dependencies For python dependencies we should support at least: with compiled extensions - minor versions initially released in the 36 months prior to our + minor versions initially released in the 24 months prior to our planned release date or the oldest that support our minimum python + numpy without complied extensions - minor versions initially released in the 24 months prior to our + minor versions initially released in the 12 months prior to our planed release date or the oldest that supports our minimum python. We will only bump these dependencies as we need new features or the @@ -77,7 +88,7 @@ specification of the dependencies. ========== ======== ====== Matplotlib Python NumPy ========== ======== ====== -3.3 3.6 1.12.0 +3.3 3.6 1.15.0 3.2 3.6 1.11.0 `3.1`_ 3.6 1.11.0 `3.0`_ 3.5 1.10.0