Skip to content

Commit 62eb4a6

Browse files
dstansbydstansby
committed
Clean up table of contents in release notes
1 parent 3c11861 commit 62eb4a6

34 files changed

+286
-277
lines changed

‎doc/conf.py

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -550,10 +550,6 @@ def js_tag_with_cache_busting(js):
550550
"cheatsheet_sidebar.html",
551551
"donate_sidebar.html",
552552
],
553-
# no sidebar for release notes, because that page is only a collection of links
554-
# to sub-pages. The sidebar would repeat all the titles of the sub-pages and
555-
# thus basically repeat all the content of the page.
556-
"users/release_notes": ["empty_sidebar.html"],
557553
# '**': ['localtoc.html', 'pagesource.html']
558554
}
559555

‎doc/devel/release_guide.rst

Lines changed: 8 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -123,26 +123,12 @@ GitHub statistics
123123
We automatically extract GitHub issue, PRs, and authors from GitHub via the API. To
124124
prepare this list:
125125

126-
1. Archive the existing GitHub statistics page.
127-
128-
a. Copy the current :file:`doc/users/github_stats.rst` to
129-
:file:`doc/users/prev_whats_new/github_stats_{X}.{Y}.{Z}.rst`.
130-
b. Change the link target at the top of the file.
131-
c. Remove the "Previous GitHub Stats" section at the end.
132-
133-
For example, when updating from v3.7.0 to v3.7.1::
134-
135-
cp doc/users/github_stats.rst doc/users/prev_whats_new/github_stats_3.7.0.rst
136-
$EDITOR doc/users/prev_whats_new/github_stats_3.7.0.rst
137-
# Change contents as noted above.
138-
git add doc/users/prev_whats_new/github_stats_3.7.0.rst
139-
140-
2. Re-generate the updated stats::
126+
1. Re-generate the stats, e.g., for version 3.7.1::
141127

142128
python tools/github_stats.py --since-tag v3.7.0 --milestone=v3.7.1 \
143-
--project 'matplotlib/matplotlib' --links > doc/users/github_stats.rst
129+
--project 'matplotlib/matplotlib' --links > doc/users/prev_whats_new/github_stats_3.7.1.rst
144130

145-
3. Review and commit changes. Some issue/PR titles may not be valid reST (the most
131+
2. Review and commit changes. Some issue/PR titles may not be valid reST (the most
146132
common issue is ``*`` which is interpreted as unclosed markup).
147133

148134
.. note::
@@ -210,22 +196,22 @@ individual files.
210196
Release notes TOC
211197
^^^^^^^^^^^^^^^^^
212198

213-
Update :file:`doc/users/release_notes.rst`:
214-
215-
- For macro and meso releases add a new section
199+
- For macro and meso releases create a new :file:`doc/users/{X}.{Y}.rst` file, and
200+
add it to the table of contents on :file:`doc/users/release_notes.rst`.
216201

217202
.. code:: rst
218203
219204
X.Y
220-
===
205+
^^^
221206
.. toctree::
222207
:maxdepth: 1
223208
224209
prev_whats_new/whats_new_X.Y.0.rst
225210
../api/prev_api_changes/api_changes_X.Y.0.rst
226211
prev_whats_new/github_stats_X.Y.0.rst
212+
227213
- For micro releases add the GitHub stats and (if present) the API changes to
228-
the existing X.Y section
214+
:file:`doc/users/{X}.{Y}.rst`
229215

230216
.. code:: rst
231217

‎doc/users/0.x.rst

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
Pre version 1.0
2+
^^^^^^^^^^^^^^^
3+
.. toctree::
4+
:maxdepth: 1
5+
6+
prev_whats_new/changelog.rst
7+
prev_whats_new/whats_new_0.99.rst
8+
../api/prev_api_changes/api_changes_0.99.x.rst
9+
../api/prev_api_changes/api_changes_0.99.rst
10+
prev_whats_new/whats_new_0.98.4.rst
11+
../api/prev_api_changes/api_changes_0.98.x.rst
12+
../api/prev_api_changes/api_changes_0.98.1.rst
13+
../api/prev_api_changes/api_changes_0.98.0.rst
14+
../api/prev_api_changes/api_changes_0.91.2.rst
15+
../api/prev_api_changes/api_changes_0.91.0.rst
16+
../api/prev_api_changes/api_changes_0.90.1.rst
17+
../api/prev_api_changes/api_changes_0.90.0.rst
18+
19+
../api/prev_api_changes/api_changes_0.87.7.rst
20+
../api/prev_api_changes/api_changes_0.86.rst
21+
../api/prev_api_changes/api_changes_0.85.rst
22+
../api/prev_api_changes/api_changes_0.84.rst
23+
../api/prev_api_changes/api_changes_0.83.rst
24+
../api/prev_api_changes/api_changes_0.82.rst
25+
../api/prev_api_changes/api_changes_0.81.rst
26+
../api/prev_api_changes/api_changes_0.80.rst
27+
28+
../api/prev_api_changes/api_changes_0.73.rst
29+
../api/prev_api_changes/api_changes_0.72.rst
30+
../api/prev_api_changes/api_changes_0.71.rst
31+
../api/prev_api_changes/api_changes_0.70.rst
32+
33+
../api/prev_api_changes/api_changes_0.65.1.rst
34+
../api/prev_api_changes/api_changes_0.65.rst
35+
../api/prev_api_changes/api_changes_0.63.rst
36+
../api/prev_api_changes/api_changes_0.61.rst
37+
../api/prev_api_changes/api_changes_0.60.rst
38+
39+
../api/prev_api_changes/api_changes_0.54.3.rst
40+
../api/prev_api_changes/api_changes_0.54.rst
41+
../api/prev_api_changes/api_changes_0.50.rst
42+
../api/prev_api_changes/api_changes_0.42.rst
43+
../api/prev_api_changes/api_changes_0.40.rst

‎doc/users/1.0.rst

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
Version 1.0
2+
^^^^^^^^^^^
3+
.. toctree::
4+
:maxdepth: 1
5+
6+
prev_whats_new/whats_new_1.0.rst

‎doc/users/1.1.rst

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
Version 1.1
2+
^^^^^^^^^^^
3+
.. toctree::
4+
:maxdepth: 1
5+
6+
prev_whats_new/whats_new_1.1.rst
7+
../api/prev_api_changes/api_changes_1.1.x.rst

‎doc/users/1.2.rst

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
Version 1.2
2+
^^^^^^^^^^^
3+
.. toctree::
4+
:maxdepth: 1
5+
6+
prev_whats_new/whats_new_1.2.2.rst
7+
prev_whats_new/whats_new_1.2.rst
8+
../api/prev_api_changes/api_changes_1.2.x.rst

‎doc/users/1.3.rst

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
Version 1.3
2+
^^^^^^^^^^^
3+
.. toctree::
4+
:maxdepth: 1
5+
6+
prev_whats_new/whats_new_1.3.rst
7+
../api/prev_api_changes/api_changes_1.3.x.rst

‎doc/users/1.4.rst

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
Version 1.4
2+
^^^^^^^^^^^
3+
.. toctree::
4+
:maxdepth: 1
5+
6+
prev_whats_new/whats_new_1.4.rst
7+
../api/prev_api_changes/api_changes_1.4.x.rst

‎doc/users/1.5.rst

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
Version 1.5
2+
^^^^^^^^^^^
3+
.. toctree::
4+
:maxdepth: 1
5+
6+
prev_whats_new/whats_new_1.5.rst
7+
../api/prev_api_changes/api_changes_1.5.3.rst
8+
../api/prev_api_changes/api_changes_1.5.2.rst
9+
../api/prev_api_changes/api_changes_1.5.0.rst

‎doc/users/2.0.rst

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
Version 2.0
2+
^^^^^^^^^^^
3+
.. toctree::
4+
:maxdepth: 1
5+
6+
prev_whats_new/whats_new_2.0.0.rst
7+
../api/prev_api_changes/api_changes_2.0.1.rst
8+
../api/prev_api_changes/api_changes_2.0.0.rst

‎doc/users/2.1.rst

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
Version 2.1
2+
^^^^^^^^^^^
3+
.. toctree::
4+
:maxdepth: 1
5+
6+
prev_whats_new/whats_new_2.1.0.rst
7+
../api/prev_api_changes/api_changes_2.1.2.rst
8+
../api/prev_api_changes/api_changes_2.1.1.rst
9+
../api/prev_api_changes/api_changes_2.1.0.rst

‎doc/users/2.2.rst

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
Version 2.2
2+
^^^^^^^^^^^
3+
.. toctree::
4+
:maxdepth: 1
5+
6+
prev_whats_new/whats_new_2.2.rst
7+
../api/prev_api_changes/api_changes_2.2.0.rst

‎doc/users/3.0.rst

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
Version 3.0
2+
^^^^^^^^^^^
3+
.. toctree::
4+
:maxdepth: 1
5+
6+
prev_whats_new/whats_new_3.0.rst
7+
../api/prev_api_changes/api_changes_3.0.1.rst
8+
../api/prev_api_changes/api_changes_3.0.0.rst
9+
prev_whats_new/github_stats_3.0.3.rst
10+
prev_whats_new/github_stats_3.0.2.rst
11+
prev_whats_new/github_stats_3.0.1.rst
12+
prev_whats_new/github_stats_3.0.0.rst

‎doc/users/3.1.rst

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
Version 3.1
2+
^^^^^^^^^^^
3+
.. toctree::
4+
:maxdepth: 1
5+
6+
prev_whats_new/whats_new_3.1.0.rst
7+
../api/prev_api_changes/api_changes_3.1.1.rst
8+
../api/prev_api_changes/api_changes_3.1.0.rst
9+
prev_whats_new/github_stats_3.1.3.rst
10+
prev_whats_new/github_stats_3.1.2.rst
11+
prev_whats_new/github_stats_3.1.1.rst
12+
prev_whats_new/github_stats_3.1.0.rst

‎doc/users/3.2.rst

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
Version 3.2
2+
^^^^^^^^^^^
3+
.. toctree::
4+
:maxdepth: 1
5+
6+
prev_whats_new/whats_new_3.2.0.rst
7+
../api/prev_api_changes/api_changes_3.2.0.rst
8+
prev_whats_new/github_stats_3.2.2.rst
9+
prev_whats_new/github_stats_3.2.1.rst
10+
prev_whats_new/github_stats_3.2.0.rst

‎doc/users/3.3.rst

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
Version 3.3
2+
^^^^^^^^^^^
3+
.. toctree::
4+
:maxdepth: 1
5+
6+
prev_whats_new/whats_new_3.3.0.rst
7+
../api/prev_api_changes/api_changes_3.3.1.rst
8+
../api/prev_api_changes/api_changes_3.3.0.rst
9+
prev_whats_new/github_stats_3.3.4.rst
10+
prev_whats_new/github_stats_3.3.3.rst
11+
prev_whats_new/github_stats_3.3.2.rst
12+
prev_whats_new/github_stats_3.3.1.rst
13+
prev_whats_new/github_stats_3.3.0.rst

‎doc/users/3.4.rst

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
Version 3.4
2+
^^^^^^^^^^^
3+
.. toctree::
4+
:maxdepth: 1
5+
6+
prev_whats_new/whats_new_3.4.0.rst
7+
../api/prev_api_changes/api_changes_3.4.2.rst
8+
../api/prev_api_changes/api_changes_3.4.0.rst
9+
prev_whats_new/github_stats_3.4.3.rst
10+
prev_whats_new/github_stats_3.4.2.rst
11+
prev_whats_new/github_stats_3.4.1.rst
12+
prev_whats_new/github_stats_3.4.0.rst

‎doc/users/3.5.rst

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
Version 3.5
2+
^^^^^^^^^^^
3+
.. toctree::
4+
:maxdepth: 1
5+
6+
prev_whats_new/whats_new_3.5.2.rst
7+
prev_whats_new/whats_new_3.5.0.rst
8+
../api/prev_api_changes/api_changes_3.5.3.rst
9+
../api/prev_api_changes/api_changes_3.5.2.rst
10+
../api/prev_api_changes/api_changes_3.5.0.rst
11+
prev_whats_new/github_stats_3.5.3.rst
12+
prev_whats_new/github_stats_3.5.2.rst
13+
prev_whats_new/github_stats_3.5.1.rst
14+
prev_whats_new/github_stats_3.5.0.rst

‎doc/users/3.6.rst

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
Version 3.6
2+
^^^^^^^^^^^
3+
.. toctree::
4+
:maxdepth: 1
5+
6+
prev_whats_new/whats_new_3.6.0.rst
7+
../api/prev_api_changes/api_changes_3.6.1.rst
8+
../api/prev_api_changes/api_changes_3.6.0.rst
9+
prev_whats_new/github_stats_3.6.3.rst
10+
prev_whats_new/github_stats_3.6.2.rst
11+
prev_whats_new/github_stats_3.6.1.rst
12+
prev_whats_new/github_stats_3.6.0.rst

‎doc/users/3.7.rst

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
Version 3.7
2+
^^^^^^^^^^^
3+
.. toctree::
4+
:maxdepth: 1
5+
6+
prev_whats_new/whats_new_3.7.0.rst
7+
../api/prev_api_changes/api_changes_3.7.0.rst
8+
prev_whats_new/github_stats_3.7.3.rst
9+
prev_whats_new/github_stats_3.7.2.rst
10+
prev_whats_new/github_stats_3.7.1.rst
11+
prev_whats_new/github_stats_3.7.0.rst

‎doc/users/3.8.rst

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
Version 3.8
2+
^^^^^^^^^^^
3+
4+
.. toctree::
5+
:maxdepth: 1
6+
7+
prev_whats_new/whats_new_3.8.0.rst
8+
../api/prev_api_changes/api_changes_3.8.1.rst
9+
../api/prev_api_changes/api_changes_3.8.0.rst
10+
prev_whats_new/github_stats_3.8.3.rst
11+
prev_whats_new/github_stats_3.8.2.rst
12+
prev_whats_new/github_stats_3.8.1.rst
13+
prev_whats_new/github_stats_3.8.0.rst

‎doc/users/github_stats.rst renamed to ‎doc/users/prev_whats_new/github_stats_3.8.3.rst

Lines changed: 1 addition & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
.. _github-stats:
1+
.. _github-stats-3-8-3:
22

33
GitHub statistics for 3.8.3 (Feb 14, 2024)
44
==========================================
@@ -137,14 +137,3 @@ Issues (18):
137137
* :ghissue:`27461`: [Doc]: API interface overview pylab incorrect import statement: from matplotlib.pyplot import *
138138
* :ghissue:`27383`: [Bug]: Error in Hexbin plot in Matplotlib 3.0 onward
139139
* :ghissue:`27358`: [Doc]: Garbled menu widget example output
140-
141-
142-
Previous GitHub statistics
143-
--------------------------
144-
145-
.. toctree::
146-
:maxdepth: 1
147-
:glob:
148-
:reversed:
149-
150-
prev_whats_new/github_stats_*

‎doc/users/prev_whats_new/whats_new_3.1.0.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ What's new in Matplotlib 3.1 (May 18, 2019)
44
===========================================
55

66
For a list of all of the issues and pull requests since the last
7-
revision, see the :ref:`github-stats`.
7+
revision, see the :ref:`github-stats-3-1-0`.
88

99
.. contents:: Table of Contents
1010
:depth: 4
@@ -179,7 +179,7 @@ changed.
179179
Alternatively to strings like ``"data"`` or ``"axes fraction"``,
180180
`.ConnectionPatch` now accepts any `~matplotlib.transforms.Transform` as input
181181
for the *coordsA* and *coordsB* arguments. This allows to draw lines between
182-
points defined in different user defined coordinate systems. Also see
182+
points defined in different user defined coordinate systems. Also see
183183
:ref:`using_connectionpatch`.
184184

185185
mplot3d Line3D now allows {set,get}_data_3d

‎doc/users/prev_whats_new/whats_new_3.2.0.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ What's new in Matplotlib 3.2 (Mar 04, 2020)
44
===========================================
55

66
For a list of all of the issues and pull requests since the last
7-
revision, see the :ref:`github-stats`.
7+
revision, see the :ref:`github-stats-3-2-0`.
88

99
.. contents:: Table of Contents
1010
:depth: 4

‎doc/users/prev_whats_new/whats_new_3.3.0.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ What's new in Matplotlib 3.3.0 (Jul 16, 2020)
55
=============================================
66

77
For a list of all of the issues and pull requests since the last
8-
revision, see the :ref:`github-stats`.
8+
revision, see the :ref:`github-stats-3-3-0`.
99

1010
.. contents:: Table of Contents
1111
:depth: 4

‎doc/users/prev_whats_new/whats_new_3.4.0.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ What's new in Matplotlib 3.4.0 (Mar 26, 2021)
55
=============================================
66

77
For a list of all of the issues and pull requests since the last revision, see
8-
the :ref:`github-stats`.
8+
the :ref:`github-stats-3-4-0`.
99

1010
.. contents:: Table of Contents
1111
:depth: 4

‎doc/users/prev_whats_new/whats_new_3.5.0.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ What's new in Matplotlib 3.5.0 (Nov 15, 2021)
33
=============================================
44

55
For a list of all of the issues and pull requests since the last revision, see
6-
the :ref:`github-stats`.
6+
the :ref:`github-stats-3-5-0`.
77

88
.. contents:: Table of Contents
99
:depth: 4

‎doc/users/prev_whats_new/whats_new_3.5.2.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ What's new in Matplotlib 3.5.2 (May 02, 2022)
33
=============================================
44

55
For a list of all of the issues and pull requests since the last revision, see
6-
the :ref:`github-stats`.
6+
the :ref:`github-stats-3-5-0`.
77

88
.. contents:: Table of Contents
99
:depth: 4

0 commit comments

Comments
 (0)