matplotlib · dstansby · Mar 7, 2017 · Mar 7, 2017 · Mar 10, 2017 · Mar 12, 2017
diff --git a/examples/axisartist/demo_axisline_style.py b/examples/axisartist/demo_axisline_style.py
@@ -1,3 +1,10 @@
+"""
+================
+Axis line styles
+================
+
+This example shows some configurations for axis style.
+"""
 
 from mpl_toolkits.axisartist.axislines import SubplotZero
 import matplotlib.pyplot as plt
@@ -9,10 +16,14 @@
     fig.add_subplot(ax)
 
     for direction in ["xzero", "yzero"]:
+        # adds arrows at the ends of each axis
         ax.axis[direction].set_axisline_style("-|>")
+
+        # adds X and Y-axis from the origin
         ax.axis[direction].set_visible(True)
 
     for direction in ["left", "right", "bottom", "top"]:
+        # hides borders
         ax.axis[direction].set_visible(False)
 
     x = np.linspace(-0.5, 1., 100)

diff --git a/examples/event_handling/keypress_demo.py b/examples/event_handling/keypress_demo.py
@@ -1,4 +1,8 @@
 """
+=========
+Key Press
+=========
+
 Show how to connect to keypress events
 """
 from __future__ import print_function

diff --git a/examples/event_handling/pipong.py b/examples/event_handling/pipong.py
@@ -1,7 +1,12 @@
-# A matplotlib based game of Pong illustrating one way to write interactive
-# animation which are easily ported to multiple backends
-# pipong.py was written by Paul Ivanov <http://pirsquared.org>
-
+"""
+====
+Pong
+====
+
+A Matplotlib based game of Pong illustrating one way to write interactive
+animations which are easily ported to multiple backends. pipong.py was written
+by `Paul Ivanov <http://pirsquared.org>`_.
+"""
 from __future__ import print_function
 
 import numpy as np

diff --git a/examples/event_handling/poly_editor.py b/examples/event_handling/poly_editor.py
@@ -1,7 +1,10 @@
 """
-This is an example to show how to build cross-GUI applications using
-matplotlib event handling to interact with objects on the canvas
+===========
+Poly Editor
+===========
 
+This is an example to show how to build cross-GUI applications using
+matplotlib event handling to interact with objects on the canvas.
 """
 import numpy as np
 from matplotlib.lines import Line2D

diff --git a/examples/event_handling/resample.py b/examples/event_handling/resample.py
@@ -1,3 +1,13 @@
+"""
+===============
+Resampling Data
+===============
+
+Downsampling lowers the sample rate or sample size of a signal. In this
+tutorial, the signal is downsampled when the plot is adjusted through dragging
+and zooming.
+"""
+
 import numpy as np
 import matplotlib.pyplot as plt
 

diff --git a/examples/mplot3d/lines3d.py b/examples/mplot3d/lines3d.py
@@ -3,7 +3,7 @@
 3D parametric curve
 ===================
 
-Demonstrating plotting a parametric curve in 3D.
+This example demonstrates plotting a parametric curve in 3D.
 '''
 
 import matplotlib as mpl

diff --git a/examples/mplot3d/mixed_subplots.py b/examples/mplot3d/mixed_subplots.py
@@ -1,9 +1,9 @@
 """
-==================
-2D and 3D subplots
-==================
+============================================
+Demonstrate the mixing of 2D and 3D subplots
+============================================
 
-Demonstrate the mixing of 2d and 3d subplots.
+This example shows a how to plot a 2D and 3D plot on the same figure.
 """
 
 from mpl_toolkits.mplot3d import Axes3D

diff --git a/examples/mplot3d/offset.py b/examples/mplot3d/offset.py
@@ -1,7 +1,7 @@
 '''
-===================
-Offset text display
-===================
+=========================
+Automatic Text Offsetting
+=========================
 
 This example demonstrates mplot3d's offset text display.
 As one rotates the 3D figure, the offsets should remain oriented the

diff --git a/examples/pylab_examples/bar_stacked.py b/examples/pylab_examples/bar_stacked.py
@@ -1,3 +1,13 @@
+"""
+=================
+Stacked Bar Graph
+=================
+
+This is an example of creating a stacked bar plot with error bars using
+plt.bar. Note the parameters *yerr* used for error bars, and *bottom*
+to stack the women's bars on top of the men's bars.
+"""
+
 # a stacked bar plot with errorbars
 import numpy as np
 import matplotlib.pyplot as plt

diff --git a/examples/pylab_examples/dolphin.py b/examples/pylab_examples/dolphin.py
@@ -1,3 +1,12 @@
+"""
+========
+Dolphins
+========
+
+This example shows how to draw, and manipulate shapes given vertices and nodes
+using the `Patches`, `Path` and `Transforms` classes.
+"""
+
 import matplotlib.cm as cm
 import matplotlib.pyplot as plt
 from matplotlib.patches import Circle, PathPatch

diff --git a/examples/pylab_examples/fill_between_demo.py b/examples/pylab_examples/fill_between_demo.py
@@ -1,3 +1,12 @@
+"""
+==============================
+Filling the area between lines
+==============================
+
+This example shows how to use `fill_between` to color between lines based on
+user-defined logic.
+"""
+
 import matplotlib.pyplot as plt
 import numpy as np
 

diff --git a/examples/pylab_examples/geo_demo.py b/examples/pylab_examples/geo_demo.py
@@ -1,3 +1,15 @@
+"""
+======================
+Geographic Projections
+======================
+
+This shows 4 possible projections using subplot.
+Matplotlib also supports
+`Basemaps Toolkit <http://matplotlib.org/basemap/`_ and
+`Cartopy <http://scitools.org.uk/cartopy/`_
+for geographic projections.
+"""
+
 import matplotlib.pyplot as plt
 
 plt.figure()

diff --git a/examples/pylab_examples/log_test.py b/examples/pylab_examples/log_test.py
@@ -1,3 +1,11 @@
+"""
+========
+Log Axis
+========
+
+This is an example of assigning a log-scale for the x-axis using `semilogx`.
+"""
+
 import matplotlib.pyplot as plt
 import numpy as np
 

diff --git a/examples/pylab_examples/mri_demo.py b/examples/pylab_examples/mri_demo.py
@@ -1,4 +1,12 @@
-"""Displays an MRI image."""
+"""
+===
+MRI
+===
+
+This example illustrates how to read an image (of an MRI) into a NumPy array,
+and display it in greyscale using `imshow`.
+
+"""
 
 import matplotlib.pyplot as plt
 import matplotlib.cbook as cbook