DOC: add more cross-ref and explanatory image [skip azp] [skip actions] [skip appveyor]

jklymak · jklymak · commit 88486b384fa0 · 2023-02-11T15:54:13.000-08:00
diff --git a/doc/_static/FigureTypes.png b/doc/_static/FigureTypes.png
diff --git a/doc/users/explain/figures.rst b/doc/users/explain/figures.rst
@@ -27,7 +27,7 @@ themselves can have multiple Artists added to them
 Viewing Figures
 ================
 
-.. figure:: ./FigureTypes.png
+.. figure:: /_static/FigureTypes.png
     :alt: Image of figure generated in jupyter notebook with inline backend,
           notebook backend, and qt5Agg backend.
 
@@ -52,9 +52,8 @@ by default trim or expand the figure size to have a tight box around Artists
 added to the Figure (see :ref:`saving_figures`, below).  If you use one of the
 non-default backends you will likely need to use an ipython "magic" like
 ``%matplotlib notebook`` for the Matplotlib
-:ref:`notebook <_jupyter_notebooks_jupyterlab>` or
-``%matplotlib widget`` for the  `ipympl <https://matplotlib.org/ipympl/>`_
-backend.
+:ref:`notebook <jupyter_notebooks_jupyterlab>` or ``%matplotlib widget`` for
+the  `ipympl <https://matplotlib.org/ipympl/>`_ backend.
 
 .. seealso::
     :ref:`interactive_figures`.
diff --git a/tutorials/introductory/quick_start.py b/tutorials/introductory/quick_start.py
@@ -31,6 +31,11 @@
 ax.plot([1, 2, 3, 4], [1, 4, 2, 3])  # Plot some data on the axes.
 
 # %%
+#
+# Note that to get this Figure to display, you may have to call ``plt.show()``,
+# depending on your backend.  For more details of Figures and backends, see
+# :ref:`figure_explanation`.
+#
 # .. _figure_parts:
 #
 # Parts of a Figure
@@ -53,13 +58,16 @@
 #    fig = plt.figure()  # an empty figure with no Axes
 #    fig, ax = plt.subplots()  # a figure with a single Axes
 #    fig, axs = plt.subplots(2, 2)  # a figure with a 2x2 grid of Axes
+#    # a figure with one axes on the left, and two on the right:
+#    fig, axs = plt.subplot_mosaic([['left', 'right-top'],
+#                                   ['left', 'right_bottom]])
 #
 # It is often convenient to create the Axes together with the Figure, but you
 # can also manually add Axes later on.  Note that many
 # :doc:`Matplotlib backends </users/explain/backends>` support zooming and
 # panning on figure windows.
 #
-# For more on Figures, see :ref:` figure_explanation`.
+# For more on Figures, see :ref:`figure_explanation`.
 #
 # :class:`~matplotlib.axes.Axes`
 # ------------------------------
