Skip to content

Doc adopt nep29 #15676

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Nov 14, 2019
Merged

Doc adopt nep29 #15676

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
2586c59
DOC/API: adopt language and timing of NEP28
tacaswell Jul 23, 2019
74c2ef7
DOC: bump numpy min version to match NEP 29
tacaswell Nov 12, 2019
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 21 additions & 10 deletions doc/devel/min_dep_policy.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
<https://numpy.org/neps/nep-0029-deprecation_policy.html>`__.


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`.

Expand All @@ -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
Expand Down Expand Up @@ -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
Expand Down