Merge pull request #20377 from anntzer/dt

timhoffm · web-flow · commit b5f9a94a761f · 2021-06-07T12:20:00.000+02:00
Cleanup some examples titles &amp; texts.
diff --git a/examples/axes_grid1/demo_colorbar_of_inset_axes.py b/examples/axes_grid1/demo_colorbar_of_inset_axes.py
@@ -1,8 +1,7 @@
 """
-===========================
-Demo Colorbar of Inset Axes
-===========================
-
+===============================
+Adding a colorbar to inset axes
+===============================
 """
 
 from matplotlib import cbook
diff --git a/examples/axes_grid1/demo_edge_colorbar.py b/examples/axes_grid1/demo_edge_colorbar.py
@@ -1,7 +1,7 @@
 """
-==================
-Demo Edge Colorbar
-==================
+===============================
+Per-row or per-column colorbars
+===============================
 
 This example shows how to use one common colorbar for each row or column
 of an image grid.
diff --git a/examples/axes_grid1/demo_fixed_size_axes.py b/examples/axes_grid1/demo_fixed_size_axes.py
@@ -1,7 +1,7 @@
 """
-====================
-Demo Fixed Size Axes
-====================
+===============================
+Axes with a fixed physical size
+===============================
 """
 
 import matplotlib.pyplot as plt
diff --git a/examples/axes_grid1/demo_imagegrid_aspect.py b/examples/axes_grid1/demo_imagegrid_aspect.py
@@ -1,25 +1,21 @@
 """
-=====================
-Demo Imagegrid Aspect
-=====================
-
+=========================================
+Setting a fixed aspect on ImageGrid cells
+=========================================
 """
-import matplotlib.pyplot as plt
 
+import matplotlib.pyplot as plt
 from mpl_toolkits.axes_grid1 import ImageGrid
+
 fig = plt.figure()
 
 grid1 = ImageGrid(fig, 121, (2, 2), axes_pad=0.1,
                   aspect=True, share_all=True)
-
 for i in [0, 1]:
     grid1[i].set_aspect(2)
 
-
 grid2 = ImageGrid(fig, 122, (2, 2), axes_pad=0.1,
                   aspect=True, share_all=True)
-
-
 for i in [1, 3]:
     grid2[i].set_aspect(2)
 
diff --git a/examples/axisartist/demo_axis_direction.py b/examples/axisartist/demo_axis_direction.py
@@ -1,8 +1,7 @@
 """
 ===================
-Demo Axis Direction
+axis_direction demo
 ===================
-
 """
 
 import numpy as np
diff --git a/examples/axisartist/demo_floating_axis.py b/examples/axisartist/demo_floating_axis.py
@@ -1,14 +1,15 @@
 """
 ==================
-Demo Floating Axis
+floating_axis demo
 ==================
 
-Axis within rectangular frame
+Axis within rectangular frame.
 
 The following code demonstrates how to put a floating polar curve within a
 rectangular box. In order to get a better sense of polar curves, please look at
 :doc:`/gallery/axisartist/demo_curvelinear_grid`.
 """
+
 import numpy as np
 import matplotlib.pyplot as plt
 import mpl_toolkits.axisartist.angle_helper as angle_helper
diff --git a/examples/subplots_axes_and_figures/subplot_demo.py b/examples/subplots_axes_and_figures/subplot_demo.py
@@ -4,9 +4,10 @@
 ==================
 
 Demo with two subplots.
-For more options, see
-:doc:`/gallery/subplots_axes_and_figures/subplots_demo`
+
+For more options, see :doc:`/gallery/subplots_axes_and_figures/subplots_demo`.
 """
+
 import numpy as np
 import matplotlib.pyplot as plt
 
diff --git a/examples/text_labels_and_annotations/demo_annotation_box.py b/examples/text_labels_and_annotations/demo_annotation_box.py
@@ -1,13 +1,12 @@
 """
 ===================
-Demo Annotation Box
+AnnotationBbox demo
 ===================
 
-The AnnotationBbox Artist creates an annotation using an OffsetBox. This
-example demonstrates three different OffsetBoxes: TextArea, DrawingArea and
-OffsetImage. AnnotationBbox gives more fine-grained control than using the axes
-method annotate.
-
+`.AnnotationBbox` creates an annotation using an `.OffsetBox`, and
+provides more fine-grained control than `.Axes.annotate`.  This example
+demonstrates the use of AnnotationBbox together with three different
+OffsetBoxes: `.TextArea`, `.DrawingArea`, and `.OffsetImage`.
 """
 
 import matplotlib.pyplot as plt
