Skip to content

Commit 17680c1

Browse files
committed
DOC: add minimum dependency version policy in writing
1 parent 45598c8 commit 17680c1

File tree

2 files changed

+43
-0
lines changed

2 files changed

+43
-0
lines changed

doc/devel/index.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,7 @@ The Matplotlib Developers' Guide
2121
gitwash/index.rst
2222
coding_guide.rst
2323
release_guide.rst
24+
min_dep_policy.rst
2425
MEP/index
2526

2627
.. toctree::

doc/devel/min_dep_policy.rst

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
.. _min_deps_policy:
2+
3+
======================================
4+
Minimum Version of Dependencies Policy
5+
======================================
6+
7+
Python and numpy
8+
================
9+
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)
15+
16+
We will bump the minimum python and numpy versions as we can every
17+
minor and major release, but never on a patch release.
18+
19+
Python Dependencies
20+
===================
21+
22+
For python dependencies we should support at least
23+
24+
with compiled extensions
25+
minor versions released in the last 3 years
26+
or the oldest that support our minimum python + numpy
27+
28+
without complied extensions
29+
minor versions released in the last 2 years or the oldest that
30+
supports our minimum python.
31+
32+
We will only bump these dependencies as we need new features or the
33+
old versions no longer support our minimum numpy or python.
34+
35+
36+
System and C-dependencies
37+
=========================
38+
39+
For system or c-dependencies (libpng, freetype, GUI frameworks, latex,
40+
gs, ffmpeg) support as old as practical. These can be difficult to
41+
install for end-users and we want to be usable on as many systems as
42+
possible. We will only bump these when absolutely necessary.

0 commit comments

Comments
 (0)