matplotlib
diff --git a/‎galleries/users_explain/figure/backends.rst
Lines changed: 19 additions & 13 deletions b/‎galleries/users_explain/figure/backends.rst
Lines changed: 19 additions & 13 deletions
diff --git a/‎galleries/users_explain/figure/figure_intro.rst
Lines changed: 5 additions & 0 deletions b/‎galleries/users_explain/figure/figure_intro.rst
Lines changed: 5 additions & 0 deletions
@@ -11,17 +11,18 @@ Backends
 What is a backend?
 ------------------
 
-A lot of documentation on the website and in the mailing lists refers
-to the "backend" and many new users are confused by this term.
-Matplotlib targets many different use cases and output formats.  Some
-people use Matplotlib interactively from the Python shell and have
-plotting windows pop up when they type commands.  Some people run
-`Jupyter <https://jupyter.org>`_ notebooks and draw inline plots for
-quick data analysis. Others embed Matplotlib into graphical user
-interfaces like PyQt or PyGObject to build rich applications.  Some
-people use Matplotlib in batch scripts to generate postscript images
-from numerical simulations, and still others run web application
-servers to dynamically serve up graphs.
+Backends are used for out-putting Matplotlib figures (see :ref:`figure-intro`),
+to the screen or for writing to files.  A lot of
+documentation on the website and in the mailing lists refers to the "backend"
+and many new users are confused by this term. Matplotlib targets many different
+use cases and output formats.  Some people use Matplotlib interactively from
+the Python shell and have plotting windows pop up when they type commands.
+Some people run `Jupyter <https://jupyter.org>`_ notebooks and draw inline
+plots for quick data analysis. Others embed Matplotlib into graphical user
+interfaces like PyQt or PyGObject to build rich applications.  Some people use
+Matplotlib in batch scripts to generate postscript images from numerical
+simulations, and still others run web application servers to dynamically serve
+up graphs.
 
 To support all of these use cases, Matplotlib can target different
 outputs, and each of these capabilities is called a backend; the
@@ -256,21 +257,23 @@ Debugging the figure windows not showing
 
 Sometimes things do not work as expected, usually during an install.
 
-If you are using a Notebook or integrated development environment (PyCharm),
+If you are using a Notebook or integrated development environment (see :ref:`notebooks-and-ides`),
 please consult their documentation for debugging figures not working in their
 environments.
 
-If you are using one of Matplotlib's graphics backends, make sure you know which
+If you are using one of Matplotlib's graphics backends (see :ref:`standalone-scripts-and-interactive-use`), make sure you know which
 one is being used:
 
 .. code-block:: python3
+
    import matplotlib
 
    print(matplotlib.get_backend())
 
 Try a simple plot, as see if the GUI opens:
 
 .. code-block:: python3
+
    import matplotlib
    import matplotlib.pyplot as plt
 
@@ -287,6 +290,7 @@ PyQT
 ^^^^
 
 .. code-block:: bash
+
    python -c "from PyQt5.QtWidgets import *; app = QApplication([]); win = QMainWindow(); win.show(); app.exec()"
 
 If you have ``PySide`` or ``PyQT6`` installed instead, just change the import
@@ -296,12 +300,14 @@ GTK
 ^^^
 
 .. code-block:: bash
+
    python3 -c 'from gi.repository import Gtk; win = Gtk.Window(); win.connect("destroy", Gtk.main_quit); win.show(); Gtk.main()'
 
 wxPython
 ^^^^^^^^
 
 .. code-block:: python3
+
    import wx
 
    app = wx.App(False)  # Create a new app, don't redirect stdout/stderr to a window.
 
@@ -2,6 +2,7 @@
 .. redirect-from:: /users/explain/figure
 
 .. _figure_explanation:
+.. _figure-intro:
 
 +++++++++++++++++++++++
 Introduction to Figures
@@ -36,6 +37,8 @@ We will discuss how to create Figures in more detail below, but first it is
 helpful to understand how to view a Figure.  This varies based on how you are
 using Matplotlib, and what :ref:`Backend <what-is-a-backend>` you are using.
 
+.. _notebooks-and-ides:
+
 Notebooks and IDEs
 ------------------
 
@@ -73,6 +76,8 @@ other than the default "inline" backend, you will likely need to use an ipython
 .. seealso::
     :ref:`interactive_figures`.
 
+.. _standalone-scripts-and-interactive-use:
+
 Standalone scripts and interactive use
 --------------------------------------