DOC FIX reviewer's comments

matplotlib · dstansby · Mar 7, 2017 · Mar 7, 2017 · Mar 10, 2017 · Mar 12, 2017
commit 091647cbb38a52384d244198d8e16e9e0599c66e
diff --git a/examples/axisartist/demo_axisline_style.py b/examples/axisartist/demo_axisline_style.py
@@ -1,6 +1,6 @@
 """
 ================
-Axis Line Styles
+Axis line styles
 ================
 
 This example shows some configurations for axis style.
@@ -18,12 +18,12 @@
     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 boarders
+        # hides borders
         ax.axis[direction].set_visible(False)
 
     x = np.linspace(-0.5, 1., 100)

diff --git a/examples/event_handling/pipong.py b/examples/event_handling/pipong.py
@@ -1,9 +1,11 @@
 """
 ====
-PONG
+Pong
 ====
 
-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>
+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 <a href='http://pirsquared.org'>Paul Ivanov</a>.
 """
 from __future__ import print_function
 

diff --git a/examples/event_handling/poly_editor.py b/examples/event_handling/poly_editor.py
@@ -4,8 +4,7 @@
 ==========
 
 This is an example to show how to build cross-GUI applications using
-matplotlib event handling to interact with objects on the canvas
-
+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
@@ -3,7 +3,9 @@
 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.
+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
@@ -14,7 +16,7 @@ class DataDisplayDownsampler(object):
     def __init__(self, xdata, ydata):
         self.origYData = ydata
         self.origXData = xdata
-        self.ratio = 50
+        self.ratio = 5
         self.delta = xdata[-1] - xdata[0]
 
     def downsample(self, xstart, xend):

diff --git a/examples/mplot3d/mixed_subplots.py b/examples/mplot3d/mixed_subplots.py
@@ -1,7 +1,7 @@
 """
-==================
-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.
 """

diff --git a/examples/pylab_examples/bar_stacked.py b/examples/pylab_examples/bar_stacked.py
@@ -3,8 +3,9 @@
 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.
+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

diff --git a/examples/pylab_examples/dolphin.py b/examples/pylab_examples/dolphin.py
@@ -1,9 +1,10 @@
 """
-=======
-Dophins
-=======
+========
+Dolphins
+========
 
-This example shows how to draw, and manipulate shapes given verticies and nodes using the patches, path and transforms classes.
+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

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

diff --git a/examples/pylab_examples/geo_demo.py b/examples/pylab_examples/geo_demo.py
@@ -4,7 +4,10 @@
 ======================
 
 This shows 4 possible projections using subplot.
-Matplotlib also supports the <a href='http://matplotlib.org/basemap/'>Basemaps Toolkit</a> for geographic projections.
+Matplotlib also supports
+<a href='http://matplotlib.org/basemap/'>Basemaps Toolkit</a> and
+<a href='http://scitools.org.uk/cartopy/'>Cartopy</a> 
+for geographic projections.
 """
 
 import matplotlib.pyplot as plt

diff --git a/examples/pylab_examples/mri_demo.py b/examples/pylab_examples/mri_demo.py
@@ -3,7 +3,8 @@
 MRI
 ===
 
-This example illustrates how to read an image (of an MRI) into a numpy array, and display it in greyscale using `ax.imshow`.
+This example illustrates how to read an image (of an MRI) into a NumPy array,
+and display it in greyscale using `imshow`.
 
 """
-Original file line number
+Diff line change
@@ Expand Up / @@ -3,7 +3,8 @@ @@
     MRI
     ===
-    This example illustrates how to read an image (of an MRI) into a numpy array, and display it in greyscale using `ax.imshow`.
+    This example illustrates how to read an image (of an MRI) into a NumPy array,
+    and display it in greyscale using `imshow`.
     """
@@ Expand Down @@