DOC: Edits of example

jklymak · jklymak · commit 6bafe2f11488 · 2020-09-15T15:41:24.000-07:00
diff --git a/examples/subplots_axes_and_figures/gridspec_nested.py b/examples/subplots_axes_and_figures/gridspec_nested.py
@@ -6,6 +6,10 @@
 GridSpecs can be nested, so that a subplot from a parent GridSpec can
 set the position for a nested grid of subplots.
 
+Note that the same functionality can be achieved more directly with
+`~.figure.PanelBase.subpanels`:
+:doc:`nested gridspecs</gallery/subplots_axes_and_figures/subpanels>`,
+
 """
 import matplotlib.pyplot as plt
 import matplotlib.gridspec as gridspec
diff --git a/examples/subplots_axes_and_figures/subpanels.py b/examples/subplots_axes_and_figures/subpanels.py
@@ -1,14 +1,16 @@
 """
 ================
-Nested Subpanels
+Figure Subpanels
 ================
-Sometimes it is desirable to have a figure that has two different
-layouts in it.  This can be achieved with
-:doc:`nested gridspecs</gallery/subplots_axes_and_figures/gridspec_nested>`
+Sometimes it is desirable to have a figure with two different layouts in it.
+This can be achieved with
+:doc:`nested gridspecs</gallery/subplots_axes_and_figures/gridspec_nested>`,
 but having a virtual figure with its own artists is helpful, so
-Matplotlib also has "subpanels", usually implimented by calling
-``.figure.PanelBase.add_subpanel`` in a way that is analagous to
-``.figure.PanelBase.add_subplot``.
+Matplotlib also has "subpanels", accessed by calling
+`.figure.PanelBase.add_subpanel` in a way that is analagous to
+`.figure.PanelBase.add_subplot`, or `.figure.PanelBase.subpanels` to make
+an array of subpanels.  Note that subpanels can also have their own child
+subpanels.
 """
 import matplotlib.pyplot as plt
 import numpy as np
