Jul 13, 2025 · Jul 16, 2025 · Jul 17, 2025
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
    LICENSE|
    lib/matplotlib/mpl-data|
    doc/devel/gitwash|
    doc/users/prev|
    doc/release/prev|
    doc/api/prev|
    lib/matplotlib/tests/data/tinypages
    )
diff --git a/doc/conf.py b/doc/conf.py
    can make partial builds very fast.
    """
 default_skip_subdirs= [
 'users/prev_whats_new/*','users/explain/*','api/*','gallery/*',
 'release/prev_whats_new/*','users/explain/*','api/*','gallery/*',
 'tutorials/*','plot_types/*','devel/*']
 try:
 withopen(".mpl_skip_subdirs.yaml",'r')asfin:
 # no sidebar for release notes, because that page is only a collection of links
 # to sub-pages. The sidebar would repeat all the titles of the sub-pages and
 # thus basically repeat all the content of the page.
 "users/release_notes": ["empty_sidebar.html"],
 "release/release_notes": ["empty_sidebar.html"],
 # '**': ['localtoc.html', 'pagesource.html']
 }

diff --git a/doc/devel/api_changes.rst b/doc/devel/api_changes.rst
 +-------------------+-----------------------------+----------------------------------------------+
 ||   versioning directive|  announcement folder|
 +===================+=============================+==============================================+
 | new feature| ``.. versionadded:: 3.N``|:file:`doc/users/next_whats_new/`|
 | new feature| ``.. versionadded:: 3.N``|:file:`doc/release/next_whats_new/`|
 +-------------------+-----------------------------+----------------------------------------------+
 | API change| ``.. versionchanged:: 3.N``|:file:`doc/api/next_api_changes/[kind]`|
 +-------------------+-----------------------------+----------------------------------------------+
 What's new notes
 """"""""""""""""

 ..include::../users/next_whats_new/README.rst
 ..include::../release/next_whats_new/README.rst
 :start-after: whats-new-guide-start
 :end-before: whats-new-guide-end

diff --git a/doc/devel/release_guide.rst b/doc/devel/release_guide.rst

 1. Archive the existing GitHub statistics page.

   a. Copy the current:file:`doc/users/github_stats.rst` to
 :file:`doc/users/prev_whats_new/github_stats_{X}.{Y}.{Z}.rst`.
   a. Copy the current:file:`doc/release/github_stats.rst` to
 :file:`doc/release/prev_whats_new/github_stats_{X}.{Y}.{Z}.rst`.
   b. Change the link target at the top of the file.
   c. Remove the "Previous GitHub Stats" section at the end.

   For example, when updating from v3.7.0 to v3.7.1::

      cp doc/users/github_stats.rst doc/users/prev_whats_new/github_stats_3.7.0.rst
      $EDITOR doc/users/prev_whats_new/github_stats_3.7.0.rst
      cp doc/release/github_stats.rst doc/release/prev_whats_new/github_stats_3.7.0.rst
      $EDITOR doc/release/prev_whats_new/github_stats_3.7.0.rst
      # Change contents as noted above.
      git add doc/users/prev_whats_new/github_stats_3.7.0.rst
      git add doc/release/prev_whats_new/github_stats_3.7.0.rst

 2. Re-generate the updated stats::

       python tools/github_stats.py --since-tag v3.7.0 --milestone=v3.7.1 \
           --project 'matplotlib/matplotlib' --links > doc/users/github_stats.rst
           --project 'matplotlib/matplotlib' --links > doc/release/github_stats.rst

 3. Review and commit changes. Some issue/PR titles may not be valid reST (the most
   common issue is ``*`` which is interpreted as unclosed markup). Also confirm that
 *Only needed for macro and meso releases. Bugfix releases should not have new
 features.*

 Merge the contents of all the files in:file:`doc/users/next_whats_new/` into a single
 file:file:`doc/users/prev_whats_new/whats_new_{X}.{Y}.0.rst` and delete the individual
 Merge the contents of all the files in:file:`doc/release/next_whats_new/` into a single
 file:file:`doc/release/prev_whats_new/whats_new_{X}.{Y}.0.rst` and delete the individual
 files.

 API changes
 Release notes TOC
 ^^^^^^^^^^^^^^^^^

 Update:file:`doc/users/release_notes.rst`:
 Update:file:`doc/release/release_notes.rst`:

 - For macro and meso releases add a new section

diff --git a/doc/index.rst b/doc/index.rst
        ..toctree::
 :maxdepth:1

 users/release_notes.rst
 release/release_notes.rst


 Contribute
diff --git a/doc/users/generate_credits.py → doc/project/generate_credits.py b/doc/users/generate_credits.py → doc/project/generate_credits.py
diff --git a/doc/users/github_stats.rst → doc/release/github_stats.rst b/doc/users/github_stats.rst → doc/release/github_stats.rst
 ..redirect-from::/users/github_stats

 .. _github-stats:

 GitHub statistics for 3.10.1 (Feb 27, 2025)
diff --git a/doc/users/next_whats_new.rst → doc/release/next_whats_new.rst b/doc/users/next_whats_new.rst → doc/release/next_whats_new.rst
 ..redirect-from::/users/next_whats_new

 .. _whats-new:

 ================
diff --git a/doc/users/next_whats_new/3d_speedups.rst → doc/release/next_whats_new/3d_speedups.rst b/doc/users/next_whats_new/3d_speedups.rst → doc/release/next_whats_new/3d_speedups.rst
diff --git a/doc/users/next_whats_new/README.rst → doc/release/next_whats_new/README.rst b/doc/users/next_whats_new/README.rst → doc/release/next_whats_new/README.rst
 be described through a "What's new" entry.

 Each entry is written into a separate file in the
 :file:`doc/users/next_whats_new/` directory. They are sorted and merged into
 :file:`doc/release/next_whats_new/` directory. They are sorted and merged into
 :file:`whats_new.rst` during the release process.

 When adding an entry please look at the currently existing files to
diff --git a/doc/users/next_whats_new/axis_inversion.rst → ...release/next_whats_new/axis_inversion.rst b/doc/users/next_whats_new/axis_inversion.rst → ...release/next_whats_new/axis_inversion.rst
diff --git a/...xt_whats_new/bar_label_padding_update.rst → ...xt_whats_new/bar_label_padding_update.rst b/...xt_whats_new/bar_label_padding_update.rst → ...xt_whats_new/bar_label_padding_update.rst
diff --git a/...t_whats_new/color_cycle_from_sequence.rst → ...t_whats_new/color_cycle_from_sequence.rst b/...t_whats_new/color_cycle_from_sequence.rst → ...t_whats_new/color_cycle_from_sequence.rst
diff --git a/...ext_whats_new/colormap_bad_under_over.rst → ...ext_whats_new/colormap_bad_under_over.rst b/...ext_whats_new/colormap_bad_under_over.rst → ...ext_whats_new/colormap_bad_under_over.rst
diff --git a/doc/users/next_whats_new/colormap_with_alpha → ...elease/next_whats_new/colormap_with_alpha b/doc/users/next_whats_new/colormap_with_alpha → ...elease/next_whats_new/colormap_with_alpha
diff --git a/...xt_whats_new/depthshading_improvement.rst → ...xt_whats_new/depthshading_improvement.rst b/...xt_whats_new/depthshading_improvement.rst → ...xt_whats_new/depthshading_improvement.rst
diff --git a/doc/users/next_whats_new/figsize_unit.rst → doc/release/next_whats_new/figsize_unit.rst b/doc/users/next_whats_new/figsize_unit.rst → doc/release/next_whats_new/figsize_unit.rst
diff --git a/doc/users/next_whats_new/gif_savefig.rst → doc/release/next_whats_new/gif_savefig.rst b/doc/users/next_whats_new/gif_savefig.rst → doc/release/next_whats_new/gif_savefig.rst
diff --git a/doc/users/next_whats_new/grouped_bar.rst → doc/release/next_whats_new/grouped_bar.rst b/doc/users/next_whats_new/grouped_bar.rst → doc/release/next_whats_new/grouped_bar.rst
diff --git a/...users/next_whats_new/last_resort_font.rst → ...lease/next_whats_new/last_resort_font.rst b/...users/next_whats_new/last_resort_font.rst → ...lease/next_whats_new/last_resort_font.rst
diff --git a/...ers/next_whats_new/log_contour_levels.rst → ...ase/next_whats_new/log_contour_levels.rst b/...ers/next_whats_new/log_contour_levels.rst → ...ase/next_whats_new/log_contour_levels.rst
diff --git a/doc/users/next_whats_new/logticks.rst → doc/release/next_whats_new/logticks.rst b/doc/users/next_whats_new/logticks.rst → doc/release/next_whats_new/logticks.rst
diff --git a/...t_whats_new/new_rcparams_grid_options.rst → ...t_whats_new/new_rcparams_grid_options.rst b/...t_whats_new/new_rcparams_grid_options.rst → ...t_whats_new/new_rcparams_grid_options.rst
diff --git a/...s/next_whats_new/separated_hatchcolor.rst → ...e/next_whats_new/separated_hatchcolor.rst b/...s/next_whats_new/separated_hatchcolor.rst → ...e/next_whats_new/separated_hatchcolor.rst
diff --git a/..._and_eight_color_petroff_color_cycles.rst → ..._and_eight_color_petroff_color_cycles.rst b/..._and_eight_color_petroff_color_cycles.rst → ..._and_eight_color_petroff_color_cycles.rst
diff --git a/...ts_new/streamplot_integration_control.rst → ...ts_new/streamplot_integration_control.rst b/...ts_new/streamplot_integration_control.rst → ...ts_new/streamplot_integration_control.rst
diff --git a/..._whats_new/streamplot_multiple_arrows.rst → ..._whats_new/streamplot_multiple_arrows.rst b/..._whats_new/streamplot_multiple_arrows.rst → ..._whats_new/streamplot_multiple_arrows.rst
diff --git a/doc/users/next_whats_new/subplots_adjust.rst → ...elease/next_whats_new/subplots_adjust.rst b/doc/users/next_whats_new/subplots_adjust.rst → ...elease/next_whats_new/subplots_adjust.rst
diff --git a/doc/users/next_whats_new/type1_subset.rst → doc/release/next_whats_new/type1_subset.rst b/doc/users/next_whats_new/type1_subset.rst → doc/release/next_whats_new/type1_subset.rst
diff --git a/...sers/next_whats_new/violinplot_colors.rst → ...ease/next_whats_new/violinplot_colors.rst b/...sers/next_whats_new/violinplot_colors.rst → ...ease/next_whats_new/violinplot_colors.rst
diff --git a/..._whats_new/xtick_ytick_rotation_modes.rst → ..._whats_new/xtick_ytick_rotation_modes.rst b/..._whats_new/xtick_ytick_rotation_modes.rst → ..._whats_new/xtick_ytick_rotation_modes.rst
diff --git a/doc/users/prev_whats_new/changelog.rst → doc/release/prev_whats_new/changelog.rst b/doc/users/prev_whats_new/changelog.rst → doc/release/prev_whats_new/changelog.rst
 .. redirect-from:: /users/prev_whats_new/changelog

 .. _old_changelog:

 List of changes to Matplotlib prior to 2015
 ===========================================

 This is a list of the changes made to Matplotlib from 2003 to 2015. For more
 recent changes, please refer to the :doc:`/users/release_notes`.
 recent changes, please refer to the :doc:`/release/release_notes`.

 2015-11-16
    Levels passed to contour(f) and tricontour(f) must be in increasing order.
 2006-01-11
    Released 0.86.1

 2006-01-11
 2006-01-11
    Fixed setup.py for win32 build and added rc template to the MANIFEST.in

 2006-01-10
diff --git a/...ers/prev_whats_new/dflt_style_changes.rst → ...ase/prev_whats_new/dflt_style_changes.rst b/...ers/prev_whats_new/dflt_style_changes.rst → ...ase/prev_whats_new/dflt_style_changes.rst
 ..redirect-from::/users/prev_whats_new/dflt_style_changes
 ..redirect-from::/users/dflt_style_changes

 ==============================
diff --git a/...ers/prev_whats_new/github_stats_3.0.0.rst → ...ase/prev_whats_new/github_stats_3.0.0.rst b/...ers/prev_whats_new/github_stats_3.0.0.rst → ...ase/prev_whats_new/github_stats_3.0.0.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.0.0

 .. _github-stats-3-0-0:

 GitHub statistics for 3.0.0 (Sep 18, 2018)
diff --git a/...ers/prev_whats_new/github_stats_3.0.1.rst → ...ase/prev_whats_new/github_stats_3.0.1.rst b/...ers/prev_whats_new/github_stats_3.0.1.rst → ...ase/prev_whats_new/github_stats_3.0.1.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.0.1

 .. _github-stats-3-0-1:

 GitHub statistics for 3.0.1 (Oct 25, 2018)
diff --git a/...ers/prev_whats_new/github_stats_3.0.2.rst → ...ase/prev_whats_new/github_stats_3.0.2.rst b/...ers/prev_whats_new/github_stats_3.0.2.rst → ...ase/prev_whats_new/github_stats_3.0.2.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.0.2

 .. _github-stats-3-0-2:

 GitHub statistics for 3.0.2 (Nov 10, 2018)
diff --git a/...ers/prev_whats_new/github_stats_3.0.3.rst → ...ase/prev_whats_new/github_stats_3.0.3.rst b/...ers/prev_whats_new/github_stats_3.0.3.rst → ...ase/prev_whats_new/github_stats_3.0.3.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.0.3

 .. _github-stats-3-0-3:

 GitHub statistics for 3.0.3 (Feb 28, 2019)
diff --git a/...ers/prev_whats_new/github_stats_3.1.0.rst → ...ase/prev_whats_new/github_stats_3.1.0.rst b/...ers/prev_whats_new/github_stats_3.1.0.rst → ...ase/prev_whats_new/github_stats_3.1.0.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.1.0

 .. _github-stats-3-1-0:

 GitHub statistics for 3.1.0 (May 18, 2019)
diff --git a/...ers/prev_whats_new/github_stats_3.1.1.rst → ...ase/prev_whats_new/github_stats_3.1.1.rst b/...ers/prev_whats_new/github_stats_3.1.1.rst → ...ase/prev_whats_new/github_stats_3.1.1.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.1.1

 .. _github-stats-3-1-1:

 GitHub statistics for 3.1.1 (Jul 02, 2019)
diff --git a/...ers/prev_whats_new/github_stats_3.1.2.rst → ...ase/prev_whats_new/github_stats_3.1.2.rst b/...ers/prev_whats_new/github_stats_3.1.2.rst → ...ase/prev_whats_new/github_stats_3.1.2.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.1.2

 .. _github-stats-3-1-2:

 GitHub statistics for 3.1.2 (Nov 21, 2019)
diff --git a/...ers/prev_whats_new/github_stats_3.1.3.rst → ...ase/prev_whats_new/github_stats_3.1.3.rst b/...ers/prev_whats_new/github_stats_3.1.3.rst → ...ase/prev_whats_new/github_stats_3.1.3.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.1.3

 .. _github-stats-3-1-3:

 GitHub statistics for 3.1.3 (Feb 03, 2020)
diff --git a/...rs/prev_whats_new/github_stats_3.10.0.rst → ...se/prev_whats_new/github_stats_3.10.0.rst b/...rs/prev_whats_new/github_stats_3.10.0.rst → ...se/prev_whats_new/github_stats_3.10.0.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.10.0

 .. _github-stats-3_10_0:

 GitHub statistics for 3.10.0 (Dec 13, 2024)
diff --git a/...ers/prev_whats_new/github_stats_3.2.0.rst → ...ase/prev_whats_new/github_stats_3.2.0.rst b/...ers/prev_whats_new/github_stats_3.2.0.rst → ...ase/prev_whats_new/github_stats_3.2.0.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.2.0

 .. _github-stats-3-2-0:

 GitHub statistics for 3.2.0 (Mar 04, 2020)
diff --git a/...ers/prev_whats_new/github_stats_3.2.1.rst → ...ase/prev_whats_new/github_stats_3.2.1.rst b/...ers/prev_whats_new/github_stats_3.2.1.rst → ...ase/prev_whats_new/github_stats_3.2.1.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.2.1

 .. _github-stats-3-2-1:

 GitHub statistics for 3.2.1 (Mar 18, 2020)
diff --git a/...ers/prev_whats_new/github_stats_3.2.2.rst → ...ase/prev_whats_new/github_stats_3.2.2.rst b/...ers/prev_whats_new/github_stats_3.2.2.rst → ...ase/prev_whats_new/github_stats_3.2.2.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.2.2

 .. _github-stats-3-2-2:

 GitHub statistics for 3.2.2 (Jun 17, 2020)
diff --git a/...ers/prev_whats_new/github_stats_3.3.0.rst → ...ase/prev_whats_new/github_stats_3.3.0.rst b/...ers/prev_whats_new/github_stats_3.3.0.rst → ...ase/prev_whats_new/github_stats_3.3.0.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.3.0

 .. _github-stats-3-3-0:

 GitHub statistics for 3.3.0 (Jul 16, 2020)
diff --git a/...ers/prev_whats_new/github_stats_3.3.1.rst → ...ase/prev_whats_new/github_stats_3.3.1.rst b/...ers/prev_whats_new/github_stats_3.3.1.rst → ...ase/prev_whats_new/github_stats_3.3.1.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.3.1

 .. _github-stats-3-3-1:

 GitHub statistics for 3.3.1 (Aug 13, 2020)
diff --git a/...ers/prev_whats_new/github_stats_3.3.2.rst → ...ase/prev_whats_new/github_stats_3.3.2.rst b/...ers/prev_whats_new/github_stats_3.3.2.rst → ...ase/prev_whats_new/github_stats_3.3.2.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.3.2

 .. _github-stats-3-3-2:

 GitHub statistics for 3.3.2 (Sep 15, 2020)
diff --git a/...ers/prev_whats_new/github_stats_3.3.3.rst → ...ase/prev_whats_new/github_stats_3.3.3.rst b/...ers/prev_whats_new/github_stats_3.3.3.rst → ...ase/prev_whats_new/github_stats_3.3.3.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.3.3

 .. _github-stats-3-3-3:

 GitHub statistics for 3.3.3 (Nov 11, 2020)
diff --git a/...ers/prev_whats_new/github_stats_3.3.4.rst → ...ase/prev_whats_new/github_stats_3.3.4.rst b/...ers/prev_whats_new/github_stats_3.3.4.rst → ...ase/prev_whats_new/github_stats_3.3.4.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.3.4

 .. _github-stats-3-3-4:

 GitHub statistics for 3.3.4 (Jan 28, 2021)
diff --git a/...ers/prev_whats_new/github_stats_3.4.0.rst → ...ase/prev_whats_new/github_stats_3.4.0.rst b/...ers/prev_whats_new/github_stats_3.4.0.rst → ...ase/prev_whats_new/github_stats_3.4.0.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.4.0

 .. _github-stats-3-4-0:

 GitHub statistics for 3.4.0 (Mar 26, 2021)
diff --git a/...ers/prev_whats_new/github_stats_3.4.1.rst → ...ase/prev_whats_new/github_stats_3.4.1.rst b/...ers/prev_whats_new/github_stats_3.4.1.rst → ...ase/prev_whats_new/github_stats_3.4.1.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.4.1

 .. _github-stats-3-4-1:

 GitHub statistics for 3.4.1 (Mar 31, 2021)
diff --git a/...ers/prev_whats_new/github_stats_3.4.2.rst → ...ase/prev_whats_new/github_stats_3.4.2.rst b/...ers/prev_whats_new/github_stats_3.4.2.rst → ...ase/prev_whats_new/github_stats_3.4.2.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.4.2

 .. _github-stats-3-4-2:

 GitHub statistics for 3.4.2 (May 08, 2021)
diff --git a/...ers/prev_whats_new/github_stats_3.4.3.rst → ...ase/prev_whats_new/github_stats_3.4.3.rst b/...ers/prev_whats_new/github_stats_3.4.3.rst → ...ase/prev_whats_new/github_stats_3.4.3.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.4.3

 .. _github-stats-3-4-3:

 GitHub statistics for 3.4.3 (August 21, 2021)
diff --git a/...ers/prev_whats_new/github_stats_3.5.0.rst → ...ase/prev_whats_new/github_stats_3.5.0.rst b/...ers/prev_whats_new/github_stats_3.5.0.rst → ...ase/prev_whats_new/github_stats_3.5.0.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.5.0

 .. _github-stats-3-5-0:

 GitHub statistics for 3.5.0 (Nov 15, 2021)
diff --git a/...ers/prev_whats_new/github_stats_3.5.1.rst → ...ase/prev_whats_new/github_stats_3.5.1.rst b/...ers/prev_whats_new/github_stats_3.5.1.rst → ...ase/prev_whats_new/github_stats_3.5.1.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.5.1

 .. _github-stats-3-5-1:

 GitHub statistics for 3.5.1 (Dec 11, 2021)
diff --git a/...ers/prev_whats_new/github_stats_3.5.2.rst → ...ase/prev_whats_new/github_stats_3.5.2.rst b/...ers/prev_whats_new/github_stats_3.5.2.rst → ...ase/prev_whats_new/github_stats_3.5.2.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.5.2

 .. _github-stats-3-5-2:

 GitHub statistics for 3.5.2 (May 02, 2022)
diff --git a/...ers/prev_whats_new/github_stats_3.5.3.rst → ...ase/prev_whats_new/github_stats_3.5.3.rst b/...ers/prev_whats_new/github_stats_3.5.3.rst → ...ase/prev_whats_new/github_stats_3.5.3.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.5.3

 .. _github-stats-3-5-3:

 GitHub statistics for 3.5.3 (Aug 10, 2022)
diff --git a/...ers/prev_whats_new/github_stats_3.6.0.rst → ...ase/prev_whats_new/github_stats_3.6.0.rst b/...ers/prev_whats_new/github_stats_3.6.0.rst → ...ase/prev_whats_new/github_stats_3.6.0.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.6.0

 .. _github-stats-3-6-0:

 GitHub statistics for 3.6.0 (Sep 15, 2022)
diff --git a/...ers/prev_whats_new/github_stats_3.6.1.rst → ...ase/prev_whats_new/github_stats_3.6.1.rst b/...ers/prev_whats_new/github_stats_3.6.1.rst → ...ase/prev_whats_new/github_stats_3.6.1.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.6.1

 .. _github-stats-3-6-1:

 GitHub statistics for 3.6.1 (Oct 08, 2022)
diff --git a/...ers/prev_whats_new/github_stats_3.6.2.rst → ...ase/prev_whats_new/github_stats_3.6.2.rst b/...ers/prev_whats_new/github_stats_3.6.2.rst → ...ase/prev_whats_new/github_stats_3.6.2.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.6.2

 .. _github-stats-3-6-2:

 GitHub statistics for 3.6.2 (Nov 02, 2022)
diff --git a/...ers/prev_whats_new/github_stats_3.6.3.rst → ...ase/prev_whats_new/github_stats_3.6.3.rst b/...ers/prev_whats_new/github_stats_3.6.3.rst → ...ase/prev_whats_new/github_stats_3.6.3.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.6.3

 .. _github-stats-3-6-3:

 GitHub statistics for 3.6.3 (Jan 11, 2023)
diff --git a/...ers/prev_whats_new/github_stats_3.7.0.rst → ...ase/prev_whats_new/github_stats_3.7.0.rst b/...ers/prev_whats_new/github_stats_3.7.0.rst → ...ase/prev_whats_new/github_stats_3.7.0.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.7.0

 .. _github-stats-3-7-0:

 GitHub statistics for 3.7.0 (Feb 13, 2023)
diff --git a/...ers/prev_whats_new/github_stats_3.7.1.rst → ...ase/prev_whats_new/github_stats_3.7.1.rst b/...ers/prev_whats_new/github_stats_3.7.1.rst → ...ase/prev_whats_new/github_stats_3.7.1.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.7.1

 .. _github-stats-3-7-1:

 GitHub statistics for 3.7.1 (Mar 03, 2023)
diff --git a/...ers/prev_whats_new/github_stats_3.7.2.rst → ...ase/prev_whats_new/github_stats_3.7.2.rst b/...ers/prev_whats_new/github_stats_3.7.2.rst → ...ase/prev_whats_new/github_stats_3.7.2.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.7.2

 .. _github-stats-3-7-2:

 GitHub statistics for 3.7.2 (Jul 05, 2023)
diff --git a/...ers/prev_whats_new/github_stats_3.7.3.rst → ...ase/prev_whats_new/github_stats_3.7.3.rst b/...ers/prev_whats_new/github_stats_3.7.3.rst → ...ase/prev_whats_new/github_stats_3.7.3.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.7.3

 .. _github-stats-3-7-3:

 GitHub statistics for 3.7.3 (Sep 11, 2023)
diff --git a/...ers/prev_whats_new/github_stats_3.8.0.rst → ...ase/prev_whats_new/github_stats_3.8.0.rst b/...ers/prev_whats_new/github_stats_3.8.0.rst → ...ase/prev_whats_new/github_stats_3.8.0.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.8.0

 .. _github-stats-3-8-0:

 GitHub statistics for 3.8.0 (Sep 14, 2023)
diff --git a/...ers/prev_whats_new/github_stats_3.8.1.rst → ...ase/prev_whats_new/github_stats_3.8.1.rst b/...ers/prev_whats_new/github_stats_3.8.1.rst → ...ase/prev_whats_new/github_stats_3.8.1.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.8.1

 .. _github-stats-3-8-1:

 GitHub statistics for 3.8.1 (Oct 31, 2023)
diff --git a/...ers/prev_whats_new/github_stats_3.8.2.rst → ...ase/prev_whats_new/github_stats_3.8.2.rst b/...ers/prev_whats_new/github_stats_3.8.2.rst → ...ase/prev_whats_new/github_stats_3.8.2.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.8.2

 .. _github-stats-3-8-2:

 GitHub statistics for 3.8.2 (Nov 17, 2023)
diff --git a/...ers/prev_whats_new/github_stats_3.8.3.rst → ...ase/prev_whats_new/github_stats_3.8.3.rst b/...ers/prev_whats_new/github_stats_3.8.3.rst → ...ase/prev_whats_new/github_stats_3.8.3.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.8.3

 .. _github-stats-3-8-3:

 GitHub statistics for 3.8.3 (Feb 14, 2024)
diff --git a/...ers/prev_whats_new/github_stats_3.8.4.rst → ...ase/prev_whats_new/github_stats_3.8.4.rst b/...ers/prev_whats_new/github_stats_3.8.4.rst → ...ase/prev_whats_new/github_stats_3.8.4.rst
 ..redirect-from::/users/prev_whats_new/github_stats_3.8.4

 .. _github-stats-3-8-4:

 GitHub statistics for 3.8.4 (Apr 03, 2024)
diff --git a/...ers/prev_whats_new/github_stats_3.9.0.rst → ...ase/prev_whats_new/github_stats_3.9.0.rst b/...ers/prev_whats_new/github_stats_3.9.0.rst → ...ase/prev_whats_new/github_stats_3.9.0.rst
 .. redirect-from:: /users/prev_whats_new/github_stats_3.9.0

 .. _github-stats-3-9-0:

 GitHub statistics for 3.9.0 (May 15, 2024)
diff --git a/...ers/prev_whats_new/github_stats_3.9.1.rst → ...ase/prev_whats_new/github_stats_3.9.1.rst b/...ers/prev_whats_new/github_stats_3.9.1.rst → ...ase/prev_whats_new/github_stats_3.9.1.rst
 .. redirect-from:: /users/prev_whats_new/github_stats_3.9.1

 .. _github-stats-3-9-1:

 GitHub statistics for 3.9.1 (Jul 04, 2024)
diff --git a/...ers/prev_whats_new/github_stats_3.9.2.rst → ...ase/prev_whats_new/github_stats_3.9.2.rst b/...ers/prev_whats_new/github_stats_3.9.2.rst → ...ase/prev_whats_new/github_stats_3.9.2.rst
 .. redirect-from:: /users/prev_whats_new/github_stats_3.9.2

 .. _github-stats-3-9-2:

 GitHub statistics for 3.9.2 (Aug 12, 2024)
Original file line number	Diff line number	Diff line change
Expand Up		@@ -8,7 +8,7 @@ exclude: \|
		LICENSE\|
		lib/matplotlib/mpl-data\|
		doc/devel/gitwash\|
		doc/users/prev\|
		doc/release/prev\|
		doc/api/prev\|
		lib/matplotlib/tests/data/tinypages
		)
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -57,7 +57,7 @@ def _parse_skip_subdirs_file():
		can make partial builds very fast.
		"""
		default_skip_subdirs= [
		'users/prev_whats_new/','users/explain/','api/','gallery/',
		'release/prev_whats_new/','users/explain/','api/','gallery/',
		'tutorials/','plot_types/','devel/*']
		try:
		withopen(".mpl_skip_subdirs.yaml",'r')asfin:
Expand DownExpand Up		@@ -595,7 +595,7 @@ def js_tag_with_cache_busting(js):
		# no sidebar for release notes, because that page is only a collection of links
		# to sub-pages. The sidebar would repeat all the titles of the sub-pages and
		# thus basically repeat all the content of the page.
		"users/release_notes": ["empty_sidebar.html"],
		"release/release_notes": ["empty_sidebar.html"],
		# '**': ['localtoc.html', 'pagesource.html']
		}

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -220,7 +220,7 @@ folder:
		+-------------------+-----------------------------+----------------------------------------------+
		\|\| versioning directive\| announcement folder\|
		+===================+=============================+==============================================+
		\| new feature\| ``.. versionadded:: 3.N``\|:file:`doc/users/next_whats_new/`\|
		\| new feature\| ``.. versionadded:: 3.N``\|:file:`doc/release/next_whats_new/`\|
		+-------------------+-----------------------------+----------------------------------------------+
		\| API change\| ``.. versionchanged:: 3.N``\|:file:`doc/api/next_api_changes/[kind]`\|
		+-------------------+-----------------------------+----------------------------------------------+
Expand DownExpand Up		@@ -306,7 +306,7 @@ API change notes
		What's new notes
		""""""""""""""""

		..include::../users/next_whats_new/README.rst
		..include::../release/next_whats_new/README.rst
		:start-after: whats-new-guide-start
		:end-before: whats-new-guide-end

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -125,22 +125,22 @@ prepare this list:

		1. Archive the existing GitHub statistics page.

		a. Copy the current:file:`doc/users/github_stats.rst` to
		:file:`doc/users/prev_whats_new/github_stats_{X}.{Y}.{Z}.rst`.
		a. Copy the current:file:`doc/release/github_stats.rst` to
		:file:`doc/release/prev_whats_new/github_stats_{X}.{Y}.{Z}.rst`.
		b. Change the link target at the top of the file.
		c. Remove the "Previous GitHub Stats" section at the end.

		For example, when updating from v3.7.0 to v3.7.1::

		cp doc/users/github_stats.rst doc/users/prev_whats_new/github_stats_3.7.0.rst
		$EDITOR doc/users/prev_whats_new/github_stats_3.7.0.rst
		cp doc/release/github_stats.rst doc/release/prev_whats_new/github_stats_3.7.0.rst
		$EDITOR doc/release/prev_whats_new/github_stats_3.7.0.rst
		# Change contents as noted above.
		git add doc/users/prev_whats_new/github_stats_3.7.0.rst
		git add doc/release/prev_whats_new/github_stats_3.7.0.rst

		2. Re-generate the updated stats::

		python tools/github_stats.py --since-tag v3.7.0 --milestone=v3.7.1 \
		--project 'matplotlib/matplotlib' --links > doc/users/github_stats.rst
		--project 'matplotlib/matplotlib' --links > doc/release/github_stats.rst

		3. Review and commit changes. Some issue/PR titles may not be valid reST (the most
		common issue is ``*`` which is interpreted as unclosed markup). Also confirm that
Expand DownExpand Up		@@ -194,8 +194,8 @@ What's new
		*Only needed for macro and meso releases. Bugfix releases should not have new
		features.*

		Merge the contents of all the files in:file:`doc/users/next_whats_new/` into a single
		file:file:`doc/users/prev_whats_new/whats_new_{X}.{Y}.0.rst` and delete the individual
		Merge the contents of all the files in:file:`doc/release/next_whats_new/` into a single
		file:file:`doc/release/prev_whats_new/whats_new_{X}.{Y}.0.rst` and delete the individual
		files.

		API changes
Expand All		@@ -211,7 +211,7 @@ individual files.
		Release notes TOC
		^^^^^^^^^^^^^^^^^

		Update:file:`doc/users/release_notes.rst`:
		Update:file:`doc/release/release_notes.rst`:

		- For macro and meso releases add a new section

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -163,7 +163,7 @@ What's new
		..toctree::
		:maxdepth:1

		users/release_notes.rst
		release/release_notes.rst


		Contribute
Expand Down
Original file line number	Diff line number	Diff line change
		@@ -1,3 +1,5 @@
		..redirect-from::/users/github_stats

		.. _github-stats:

		GitHub statistics for 3.10.1 (Feb 27, 2025)
Expand Down
Original file line number	Diff line number	Diff line change
		@@ -1,3 +1,5 @@
		..redirect-from::/users/next_whats_new

		.. _whats-new:

		================
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -15,7 +15,7 @@ Each new feature (e.g. function, parameter, config value, behavior, ...) must
		be described through a "What's new" entry.

		Each entry is written into a separate file in the
		:file:`doc/users/next_whats_new/` directory. They are sorted and merged into
		:file:`doc/release/next_whats_new/` directory. They are sorted and merged into
		:file:`whats_new.rst` during the release process.

		When adding an entry please look at the currently existing files to
Expand Down
Original file line number	Diff line number	Diff line change
		@@ -1,10 +1,12 @@
		.. redirect-from:: /users/prev_whats_new/changelog

		.. _old_changelog:

		List of changes to Matplotlib prior to 2015
		===========================================

		This is a list of the changes made to Matplotlib from 2003 to 2015. For more
		recent changes, please refer to the :doc:`/users/release_notes`.
		recent changes, please refer to the :doc:`/release/release_notes`.

		2015-11-16
		Levels passed to contour(f) and tricontour(f) must be in increasing order.
Expand DownExpand Up		@@ -4272,7 +4274,7 @@ recent changes, please refer to the :doc:`/users/release_notes`.
		2006-01-11
		Released 0.86.1

		2006-01-11
		2006-01-11
		Fixed setup.py for win32 build and added rc template to the MANIFEST.in

		2006-01-10
Expand Down
Original file line number	Diff line number	Diff line change
		@@ -1,3 +1,4 @@
		..redirect-from::/users/prev_whats_new/dflt_style_changes
		..redirect-from::/users/dflt_style_changes

		==============================
Expand Down