diff options
author | Thomas A Caswell <tcaswell@gmail.com> | 2019-08-14 14:23:16 -0400 |
---|---|---|
committer | Thomas A Caswell <tcaswell@gmail.com> | 2019-08-14 14:46:01 -0400 |
commit | 90bd95355d0517da2d6047459b5df8826e6b16fc (patch) | |
tree | da7b7bd77023989349bfc4e5da4703cce4d9e040 /doc | |
parent | 7e55f9033e1f322ddc63dcbba0b52936e19ff395 (diff) | |
download | numpy-90bd95355d0517da2d6047459b5df8826e6b16fc.tar.gz |
DOC: clarify that these are minimum support guide lines
Projects that want to support longer time windows can, but this NEP is
setting a minimum floor for the support window.
Diffstat (limited to 'doc')
-rw-r--r-- | doc/neps/nep-0029-deprecation_policy.rst | 25 |
1 files changed, 15 insertions, 10 deletions
diff --git a/doc/neps/nep-0029-deprecation_policy.rst b/doc/neps/nep-0029-deprecation_policy.rst index 9bc30050f..fef0dc995 100644 --- a/doc/neps/nep-0029-deprecation_policy.rst +++ b/doc/neps/nep-0029-deprecation_policy.rst @@ -46,10 +46,12 @@ For the purposes of this NEP we assume semantic versioning and define: When a project creates a new major or minor version, we recommend that -the project should support all minor versions of Python introduced -and released in the prior 42 months ~~from their anticipated release -date~~ and all minor versions of NumPy released in the prior 24 -months. +the project should support at least all minor versions of Python +introduced and released in the prior 42 months ~~from their +anticipated release date~~ with a minimum of 2 minor versions of +Python, and all minor versions of NumPy released in the prior 24 +months ~~from their anticipated release date~~ with a minimum of 3 +minor versions of NumPy. The diagram:: @@ -79,7 +81,7 @@ This six month buffer provides resilience to minor fluctuations / delays in the Python release schedule. Because Python minor version support is based on historical release -dates, a 42 month time window, and a project's plans, a project can +dates, a 36 month time window, and a project's plans, a project can decide to drop a given minor version of Python very early in the release process. @@ -136,21 +138,24 @@ We suggest that all projects adopt the following language into their development guidelines: - - This project supports minor versions of Python initially released - 42 months prior to a planned project release date. + - This project supports at least the minor versions of Python + initially released 42 months prior to a planned project release + date. - The project will always support at least the 2 latest minor - versions of Python + versions of Python. - support minor versions of ``numpy`` initially released in the 24 months prior to a planned project release date or the oldest version that supports the minimum Python version (whichever is - higher) + higher). + - The project will always support at least the 3 latest minor + versions of NumPy. The minimum supported version of Python will be set to ``python_requires`` in ``setup``. All supported minor versions of Python will be in the test matrix and have binary artifacts built for releases. - The project will bump (adjust upward) the minimum Python and NumPy + The project should adjust upward the minimum Python and NumPy version support on every minor and major release, but never on a patch release. |