matplotlib
diff --git a/‎tutorials/introductory/usage.py
Lines changed: 16 additions & 17 deletions b/‎tutorials/introductory/usage.py
Lines changed: 16 additions & 17 deletions
@@ -254,7 +254,7 @@ def my_plotter(ax, data1, data2, param_dict):
 #
 # Line widths are typically in typographic points (1 pt = 1/72 inch) and
 # available for artists that have stroked lines.  Similarly, stroked lines
-# can have a linestyle.  See the `linestyles example
+# can have a linestyle.  See the :doc:`linestyles example
 # </gallery/lines_bars_and_markers/linestyles>`.
 #
 # Marker size depends on the method being used.  `~.Axes.plot` specifies
@@ -266,10 +266,13 @@ def my_plotter(ax, data1, data2, param_dict):
 # Labelling plots
 # ===============
 #
-# `~.Axes.text` can be used to add text in an arbitrary location, and
+# Axes labels and text
+# --------------------
+#
 # `~.Axes.set_xlabel`, `~.Axes.set_ylabel` and `~.Axes.set_title` are used to
 # add text in the indicated locations (see :doc:`/tutorials/text/text_intro` for
-# more discussion)
+# more discussion).  Text can also be directly added to plots using
+# `~.Axes.text`:
 
 mu, sigma = 100, 15
 x = mu + sigma * np.random.randn(10000)
@@ -354,7 +357,7 @@ def my_plotter(ax, data1, data2, param_dict):
 # Axis scales and ticks
 # =====================
 #
-# Each Axes has two (or three) `~.Axis` objects represnting the x- and y-axis.
+# Each Axes has two (or three) `~.axis.Axis` objects represnting the x- and y-axis.
 # These control the *scale* of the axis, the tick *Locators* and the tick
 # *Formatters*.
 #
@@ -365,7 +368,7 @@ def my_plotter(ax, data1, data2, param_dict):
 # such as a log-scale.  Since log-scales are used so much there are also
 # direct methods like `~.Axes.loglog`, `~.Axes.semilogx`, and
 # `~.Axes.semilogy`.  There are a number of scales (see
-# :doc:`/gallery/scales/` for other examples).  Here we set the scale
+# :doc:`/gallery/scales/scales` for other examples).  Here we set the scale
 # manually:
 
 fig, axs = plt.subplots(1, 2, figsize=(5, 2.7), constrained_layout=True)
@@ -379,7 +382,7 @@ def my_plotter(ax, data1, data2, param_dict):
 # The scale sets the mapping from data values to spacing along the Axis. This
 # happens in both directions, and gets combined into a *transform*, which
 # is the way that Matplotlib maps from data co-ordinates to Axes, Figure, or
-# screen co-ordinates.  See doc:`/tutorials/advanced/transforms_tutorial`.
+# screen co-ordinates.  See :doc:`/tutorials/advanced/transforms_tutorial`.
 #
 # Tick locators and formatters
 # ----------------------------
@@ -399,8 +402,8 @@ def my_plotter(ax, data1, data2, param_dict):
 ##############################################################################
 # Different scales can have different locators and formatters; for instance
 # the log-scale above uses `~.LogLocator` and `~.LogFormatter`. See
-# :doc:`/gallery/ticks_and_spines/tick-locators` and
-# :doc:gallery/ticks_and_spines/tick-formatters` for other formatters and
+# :doc:`/gallery/ticks/tick-locators` and
+# :doc:gallery/ticks/tick-formatters` for other formatters and
 # locators and information for writing your own.
 #
 # Plotting dates and strings
@@ -409,20 +412,16 @@ def my_plotter(ax, data1, data2, param_dict):
 # Matplotlib can handle plotting arrays of dates and arrays of strings as
 # well as floating point numbers.  These get special locators and formatters
 # as appropriate.  For dates:
-#
 
 fig, ax = plt.subplots(figsize=(5, 3.7), constrained_layout=True)
-dates = np.arange(np.datetime64('2021-11-15'), np.datetime64('2021-11-25'),
+dates = np.arange(np.datetime64('2021-11-15'), np.datetime64('2021-12-25'),
                   np.timedelta64(1, 'h'))
-
-ax.plot(dates, np.arange(len(dates)))
-# these tick labels will over-run each other so we turn them 45 degrees:
-for tick in ax.get_xticklabels():
-    tick.set_rotation(45)
-    tick.set_horizontalalignment('right')
+data = np.cumsum(np.random.randn(len(dates)))
+ax.plot(dates, data)
 
 ##############################################################################
-# For more information see the date examples in :doc:`/gallery/ticks/`
+# For more information see the date examples
+# (e.g. :doc:`/gallery/text_labels_and_annotations/date`)
 #
 # For strings, we get categorical plotting (see:
 # :doc:`/gallery/lines_bars_and_markers/categorical_variables`).