FIX

jklymak · jklymak · commit 31d0a176c3c3 · 2023-03-06T17:28:12.000-08:00
diff --git a/doc/users/prev_whats_new/whats_new_3.7.0.rst b/doc/users/prev_whats_new/whats_new_3.7.0.rst
@@ -445,7 +445,7 @@ functions can e.g. attach callbacks or modify the toolbar.  See
 
 New & Improved Narrative Documentation
 ======================================
-* Brand new :doc:`Animations </tutorials/introductory/animation_tutorial>` tutorial.
+* Brand new :ref:`Animations <animations>` tutorial.
 * New grouped and stacked `bar chart <../../gallery/index.html#lines_bars_and_markers>`_ examples.
 * New section for new contributors and reorganized git instructions in the :ref:`contributing guide<contributing>`.
 * Restructured :ref:`annotations` tutorial.
diff --git a/galleries/examples/event_handling/README.txt b/galleries/examples/event_handling/README.txt
@@ -3,7 +3,7 @@
 Event handling
 ==============
 
-Matplotlib supports :doc:`event handling</users/explain/event_handling>` with
+Matplotlib supports :ref:`event handling <event_handling>` with
 a GUI neutral event model, so you can connect to Matplotlib events without
 knowledge of what user interface Matplotlib will ultimately be plugged in to.
 This has two advantages: the code you write will be more portable, and
diff --git a/galleries/examples/subplots_axes_and_figures/auto_subplots_adjust.py b/galleries/examples/subplots_axes_and_figures/auto_subplots_adjust.py
@@ -19,7 +19,7 @@
 set the subplot parameters accordingly. Its main purpose is to illustrate
 some advanced concepts like reading out text positions, working with
 bounding boxes and transforms and using
-:ref:`events <event-handling-tutorial>`. But it can also serve as a starting
+:ref:`events <event-handling>`. But it can also serve as a starting
 point if you want to automate the layouting and need more flexibility than
 tight layout and constrained layout.
 
diff --git a/galleries/users_explain/animations/blitting.py b/galleries/users_explain/animations/blitting.py
@@ -1,5 +1,5 @@
 """
-.. redirected-from: /tutorials/advanced/blitting
+.. redirect-from:: /tutorials/advanced/blitting
 
 .. _blitting:
 
diff --git a/galleries/users_explain/artists/index.rst b/galleries/users_explain/artists/index.rst
@@ -138,7 +138,7 @@ Changing Artist data
 In addition to styling properties like *color* and *linewidth*, the Line2D
 object has a *data* property.  You can set the data after the line has been
 created using `.Line2D.set_data`.  This is often used for Animations, where the
-same line is shown evolving over time (see :doc:`../animations`)
+same line is shown evolving over time (see :doc:`../animations/index`)
 
 .. plot::
     :include-source:
diff --git a/galleries/users_explain/artists/transforms_tutorial.py b/galleries/users_explain/artists/transforms_tutorial.py
@@ -213,7 +213,7 @@
 #   This is one good reason why you rarely want to work in *display*
 #   space, but you can connect to the ``'on_draw'``
 #   :class:`~matplotlib.backend_bases.Event` to update *figure*
-#   coordinates on figure draws; see :ref:`event-handling-tutorial`.
+#   coordinates on figure draws; see :ref:`event-handling`.
 #
 # When you change the x or y limits of your axes, the data limits are
 # updated so the transformation yields a new display point.  Note that
diff --git a/galleries/users_explain/axes/index.rst b/galleries/users_explain/axes/index.rst
@@ -5,7 +5,7 @@ Axes (or Subplots)
 
 Matplotlib `~.axes.Axes` are the gateway to creating your data visualizations.
 Once an Axes is placed on a figure there are many methods that can be used to
-add data to the Axes. An Axes typically has a pair of :ref:`Axis <../axis/>`
+add data to the Axes. An Axes typically has a pair of :doc:`Axis <../axis/index>`
 Artists that define the data co-ordinate system, and include methods to add
 annotations like x- and y-labels, titles, and legends.
 
@@ -130,7 +130,7 @@ Note that text can also be added to axes using `~.axes.Axes.text`, and `~.axes.A
 Axes limits, scales, and ticking
 --------------------------------
 
-Each Axes has two (or more) `~.axis.Axis` objects, that can be accessed via :attr:`~matplotlib.axes.Axes.xaxis` and :attr:`~matplotlib.axes.Axes.yaxis` properties.  These have substantial number of methods on them, and for highly customizable Axis-es it is useful to read more about that API (:doc:`axis/index`).   However, the Axes class offers a number of helpers for the most common of these methods.  Indeed, the `~.axes.Axes.set_xlabel`, discussed above, is a helper for the `~.Axis.set_label_text`.
+Each Axes has two (or more) `~.axis.Axis` objects, that can be accessed via :attr:`~matplotlib.axes.Axes.xaxis` and :attr:`~matplotlib.axes.Axes.yaxis` properties.  These have substantial number of methods on them, and for highly customizable Axis-es it is useful to read more about that API (:doc:`../axis/index`).   However, the Axes class offers a number of helpers for the most common of these methods.  Indeed, the `~.axes.Axes.set_xlabel`, discussed above, is a helper for the `~.Axis.set_label_text`.
 
 Other important methods set the extent on the axes (`~.axes.Axes.set_xlim`, `~.axes.Axes.set_ylim`), or more fundamentally the scale of the axes.  So for instance, we can make an Axis have a logarithmic scale, and zoom in on a sub-portion of the data:
 
diff --git a/galleries/users_explain/axes/legend_guide.py b/galleries/users_explain/axes/legend_guide.py
@@ -1,5 +1,5 @@
 """
-.. redirect-from: /tutorials/intermediate/legend_guide
+.. redirect-from:: /tutorials/intermediate/legend_guide
 
 .. _legend_guide:
 
diff --git a/galleries/users_explain/figure/event_handling.rst b/galleries/users_explain/figure/event_handling.rst
@@ -1,6 +1,7 @@
 .. redirect-from:: /users/event_handling
 
-.. _event-handling-tutorial:
+.. _event-handling:
+.. _event_handling:
 
 **************************
 Event handling and picking
diff --git a/galleries/users_explain/figure/interactive.rst b/galleries/users_explain/figure/interactive.rst
@@ -53,7 +53,7 @@ collected. `.Figure`\s can be closed and deregistered from `.pyplot` individuall
    For more discussion of Matplotlib's event system and integrated event loops:
 
    - :ref:`interactive_figures_and_eventloops`
-   - :ref:`event-handling-tutorial`
+   - :ref:`event-handling`
 
 
 .. _ipython-pylab:
diff --git a/galleries/users_explain/figure/interactive_guide.rst b/galleries/users_explain/figure/interactive_guide.rst
@@ -18,7 +18,7 @@ you can use to build sophisticated interactive graphs.
 This guide is meant to be an introduction to the low-level details of
 how Matplotlib integration with a GUI event loop works.  For a more
 practical introduction to the Matplotlib event API see :ref:`event
-handling system <event-handling-tutorial>`, `Interactive Tutorial
+handling system <event-handling>`, `Interactive Tutorial
 <https://github.com/matplotlib/interactive_tutorial>`__, and
 `Interactive Applications using Matplotlib
 <http://www.amazon.com/Interactive-Applications-using-Matplotlib-Benjamin/dp/1783988843>`__.
@@ -64,7 +64,7 @@ capturing user interactions and passing them back to the application
 details depend on the toolkit.  Matplotlib has a :ref:`backend
 <what-is-a-backend>` for each GUI toolkit we support which uses the
 toolkit API to bridge the toolkit UI events into Matplotlib's :ref:`event
-handling system <event-handling-tutorial>`.  You can then use
+handling system <event-handling>`.  You can then use
 `.FigureCanvasBase.mpl_connect` to connect your function to
 Matplotlib's event handling system.  This allows you to directly
 interact with your data and write GUI toolkit agnostic user

Original file line number	Diff line number	Diff line change
`@@ -213,7 +213,7 @@`
`213`	`213`	`# This is one good reason why you rarely want to work in display`
`214`	`214`	# space, but you can connect to the ``'on_draw'``
`215`	`215`	# :class:`~matplotlib.backend_bases.Event` to update figure
`216`		-# coordinates on figure draws; see :ref:`event-handling-tutorial`.
	`216`	+# coordinates on figure draws; see :ref:`event-handling`.
`217`	`217`	`#`
`218`	`218`	`# When you change the x or y limits of your axes, the data limits are`
`219`	`219`	`# updated so the transformation yields a new display point. Note that`