Skip to content

Commit fc69f36

Browse files
meeseeksmachinetimhoffm
authored andcommitted
Backport PR #12504: DOC: clarify min supported version wording (#12519)
1 parent a5ecb15 commit fc69f36

File tree

1 file changed

+32
-10
lines changed

1 file changed

+32
-10
lines changed

doc/devel/min_dep_policy.rst

Lines changed: 32 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -4,34 +4,56 @@
44
Minimum Version of Dependencies Policy
55
======================================
66

7+
For the purpose of this document, 'minor version' is in the sense of
8+
SemVer (major, minor, patch) and includes both major and minor
9+
releases. For projects that use date-based versioning, every release
10+
is a 'minor version'.
11+
12+
713
Python and numpy
814
================
915

10-
- support minor versions of ``Python`` initially released in the previous
11-
3 years
12-
- support minor versions of ``numpy`` initially released in the
13-
previous 3 years or oldest that supports the minimum python version
14-
(which ever is higher)
16+
- support minor versions of ``Python`` initially released
17+
36 months prior to our planned release date.
18+
- support minor versions of ``numpy`` initially released in the 36
19+
months prior to our planned release date or oldest that supports the
20+
minimum python version (which ever is higher)
1521

1622
We will bump the minimum python and numpy versions as we can every
1723
minor and major release, but never on a patch release.
1824

1925
Python Dependencies
2026
===================
2127

22-
For python dependencies we should support at least
28+
For python dependencies we should support at least:
2329

2430
with compiled extensions
25-
minor versions released in the last 3 years
26-
or the oldest that support our minimum python + numpy
31+
minor versions initially released in the 36 months prior to our
32+
planned release date or the oldest that support our minimum python +
33+
numpy
2734

2835
without complied extensions
29-
minor versions released in the last 2 years or the oldest that
30-
supports our minimum python.
36+
minor versions initially released in the 24 months prior to our
37+
planed release date or the oldest that supports our minimum python.
3138

3239
We will only bump these dependencies as we need new features or the
3340
old versions no longer support our minimum numpy or python.
3441

42+
Test and Documentation Dependencies
43+
===================================
44+
45+
As these packages are only needed for testing or building the docs and
46+
not needed by end-users, we can be more aggressive about dropping
47+
support for old versions. However, we need to be careful to not
48+
over-run what down-stream packagers support (as most of the run the
49+
tests and build the documentation as part of the packaging process).
50+
51+
We will support at least minor versions of the development
52+
dependencies released in the 12 months prior to our planned release.
53+
54+
We will only bump these as needed or versions no longer support our
55+
minimum Python and numpy.
56+
3557

3658
System and C-dependencies
3759
=========================

0 commit comments

Comments
 (0)