Cleanup the text of two mpl_toolkits examples.

anntzer · anntzer · commit cd3d28f64f98 · 2019-01-16T14:55:10.000+01:00
diff --git a/examples/axisartist/demo_floating_axes.py b/examples/axisartist/demo_floating_axes.py
@@ -1,19 +1,17 @@
 """
-==================
-Demo Floating Axes
-==================
-
-Demo of the floating axes.
-
-This demo shows features of functions in floating_axes:
-    * Using scatter function and bar function with changing the
-      shape of the plot.
-    * Using GridHelperCurveLinear to rotate the plot and set the
-      boundary of the plot.
-    * Using FloatingSubplot to create a subplot using the return
-      value from GridHelperCurveLinear.
-    * Making sector plot by adding more features to GridHelperCurveLinear.
+=====================================================
+:mod:`mpl_toolkits.axisartist.floating_axes` features
+=====================================================
+
+Demonstration of features of the :mod:`.floating_axes` module:
+
+* Using `scatter` and `bar` with changing the shape of the plot.
+* Using `GridHelperCurveLinear` to rotate the plot and set the plot boundary.
+* Using `FloatingSubplot` to create a subplot using the return value from
+  `GridHelperCurveLinear`.
+* Making a sector plot by adding more features to `GridHelperCurveLinear`.
 """
+
 from matplotlib.transforms import Affine2D
 import mpl_toolkits.axisartist.floating_axes as floating_axes
 import numpy as np
diff --git a/examples/axisartist/demo_parasite_axes.py b/examples/axisartist/demo_parasite_axes.py
@@ -1,20 +1,22 @@
 """
 ==================
-Demo Parasite Axes
+Parasite Axes demo
 ==================
 
 Create a parasite axes. Such axes would share the x scale with a host axes,
 but show a different scale in y direction.
 
-Note that this approach uses the `~mpl_toolkits.axes_grid1.parasite_axes`\'
-`~.mpl_toolkits.axes_grid1.parasite_axes.HostAxes` and
-`~.mpl_toolkits.axes_grid1.parasite_axes.ParasiteAxes`. An alternative
-approach using the :ref:`toolkit_axesgrid1-index` and
-:ref:`toolkit_axisartist-index`
-is found in the :doc:`/gallery/axisartist/demo_parasite_axes2` example.
-An alternative approach using the usual matplotlib subplots is shown in
-the :doc:`/gallery/ticks_and_spines/multiple_yaxis_with_spines` example.
+This approach uses `mpl_toolkits.axes_grid1.parasite_axes.HostAxes` and
+`mpl_toolkits.axes_grid1.parasite_axes.ParasiteAxes`.
+
+An alternative approach using standard Matplotlib subplots is shown in the
+:doc:`/gallery/ticks_and_spines/multiple_yaxis_with_spines` example.
+
+An alternative approach using the :ref:`toolkit_axesgrid1-index`
+and :ref:`toolkit_axisartist-index` is found in the
+:doc:`/gallery/axisartist/demo_parasite_axes2` example.
 """
+
 from mpl_toolkits.axisartist.parasite_axes import HostAxes, ParasiteAxes
 import matplotlib.pyplot as plt
 
