@@ -155,3 +155,49 @@ Matplotlib Python NumPy
155
155
.. _`1.5` : https://matplotlib.org/1.5.0/users/installing.html#required-dependencies
156
156
.. _`1.4` : https://matplotlib.org/1.4.0/users/installing.html#required-dependencies
157
157
.. _`1.3` : https://matplotlib.org/1.3.0/users/installing.html#build-requirements
158
+
159
+
160
+ Updating Python and NumPy versions
161
+ ==================================
162
+
163
+ To update the minimum versions of Python we need to update:
164
+
165
+ - ``pyproject.toml `` (classifiers, requires-python, ``[ruff.tool] `` target-version)
166
+ - ``environment.yml ``
167
+ - ``doc/install/dependencies.rst ``
168
+ - ``doc/devel/min_dep_policy.rst `` (this file)
169
+ - CI configuration files (circle, GHA, azure)
170
+
171
+ To update the minimum NumPy we need to update:
172
+
173
+ - ``pyproject.toml ``
174
+ - ``environment.yml ``
175
+ - ``doc/install/dependencies.rst ``
176
+ - ``doc/devel/min_dep_policy.rst `` (this file)
177
+ - ``requirements/testing/minver.txt ``
178
+ - ``lib/matplotlib/__init__.py `` (matplotlib._check_versions())
179
+
180
+
181
+ The work to leverage new features or remove workarounds for no-longer supported
182
+ versions should be done in a follow-on PRs to keep the version bump PRs well
183
+ scoped.
184
+
185
+ In both cases add an api_changes/development with the following template:
186
+
187
+ .. rst ::
188
+
189
+ Increase to minimum supported versions of dependencies
190
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
191
+
192
+ For Matplotlib 3.ZZ, the :ref: `minimum supported versions <dependencies >` are
193
+ being bumped:
194
+
195
+ +------------+-----------------+----------------+
196
+ | Dependency | min in mpl3.N | min in mpl3.M |
197
+ +============+=================+================+
198
+ | Python | 3.XX | 3.AA |
199
+ | NumPy | 1.YY | 1.BB |
200
+ +------------+-----------------+----------------+
201
+
202
+ This is consistent with our :ref: `min_deps_policy ` and `SPEC0
203
+ <https://scientific-python.org/specs/spec-0000/> `__
0 commit comments