DOC: link toplevel index [ci doc]

jklymak · jklymak · commit 24055e68e55f · 2023-09-01T09:16:36.000-07:00
diff --git a/doc/api/figure_api.rst b/doc/api/figure_api.rst
@@ -187,6 +187,8 @@ Getting and modifying state
    Figure.draw_without_rendering
    Figure.draw_artist
 
+.. _figure-api-subfigure:
+
 SubFigure
 =========
 
diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
@@ -2162,16 +2162,15 @@ class SubFigure(FigureBase):
     """
     Logical figure that can be placed inside a figure.
 
+    See :ref:`figure-api-subfigure` for an index of methods on this class.
     Typically instantiated using `.Figure.add_subfigure` or
     `.SubFigure.add_subfigure`, or `.SubFigure.subfigures`.  A subfigure has
     the same methods as a figure except for those particularly tied to the size
     or dpi of the figure, and is confined to a prescribed region of the figure.
     For example the following puts two subfigures side-by-side::
 
-        fig = plt.figure()
-        sfigs = fig.subfigures(1, 2)
-        axsL = sfigs[0].subplots(1, 2)
-        axsR = sfigs[1].subplots(2, 1)
+        fig = plt.figure() sfigs = fig.subfigures(1, 2) axsL =
+        sfigs[0].subplots(1, 2) axsR = sfigs[1].subplots(2, 1)
 
     See :doc:`/gallery/subplots_axes_and_figures/subfigures`
 
@@ -2373,6 +2372,8 @@ class Figure(FigureBase):
     """
     The top level container for all the plot elements.
 
+    See `matplotlib.figure` for an index of class methods.
+
     Attributes
     ----------
     patch
