|
4 | 4 | Minimum Version of Dependencies Policy
|
5 | 5 | ======================================
|
6 | 6 |
|
| 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 | + |
7 | 13 | Python and numpy
|
8 | 14 | ================
|
9 | 15 |
|
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) |
15 | 21 |
|
16 | 22 | We will bump the minimum python and numpy versions as we can every
|
17 | 23 | minor and major release, but never on a patch release.
|
18 | 24 |
|
19 | 25 | Python Dependencies
|
20 | 26 | ===================
|
21 | 27 |
|
22 |
| -For python dependencies we should support at least |
| 28 | +For python dependencies we should support at least: |
23 | 29 |
|
24 | 30 | 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 |
27 | 34 |
|
28 | 35 | 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. |
31 | 38 |
|
32 | 39 | We will only bump these dependencies as we need new features or the
|
33 | 40 | old versions no longer support our minimum numpy or python.
|
34 | 41 |
|
| 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 | + |
35 | 57 |
|
36 | 58 | System and C-dependencies
|
37 | 59 | =========================
|
|
0 commit comments