addressing comments

choldgraf · choldgraf · commit 7e5bee994a44 · 2017-05-10T22:31:35.000-07:00
diff --git a/doc/api/pyplot_summary.rst b/doc/api/pyplot_summary.rst
@@ -21,13 +21,15 @@ The Object-Oriented API
 
 Most of these functions also exist as methods in the
 :class:`matplotlib.axes.Axes` class. You can use them with the
-so-called "Object Oriented" approach to Matplotlib.
+"Object Oriented" approach to Matplotlib.
 
 While it is easy to quickly generate plots with the
 :mod:`matplotlib.pyplot` module,
 we recommend using the object-oriented approach for more control
-and customization of your plots. For some examples of the OO approach
-to Matplotlib, see the :ref:`api_examples` examples.
+and customization of your plots. See the methods in the
+:meth:`matplotlib.axes.Axes` class for many of the same plotting functions.
+For examples of the OO approach to Matplotlib, see the
+:ref:`API Examples<api_examples>`.
 
 Colors in Matplotlib
 --------------------
diff --git a/examples/lines_bars_and_markers/categorical_variables.py b/examples/lines_bars_and_markers/categorical_variables.py
@@ -6,10 +6,8 @@
 How to use categorical variables in matplotlib.
 
 Many times you want to create a plot that uses categorical variables
-in Matplotlib. For example, your data may naturally fall into
-several "bins" and you're interested in summarizing the data per
-bin. Matplotlib allows you to pass categorical variables directly to
-many plotting functions.
+in Matplotlib. Matplotlib allows you to pass categorical variables directly to
+many plotting functions, which we demonstrate below.
 """
 import matplotlib.pyplot as plt
 
diff --git a/tutorials/01_introductory/pyplot.py b/tutorials/01_introductory/pyplot.py
@@ -124,7 +124,7 @@
 # Plotting with categorical variables
 # ===================================
 #
-# It is also possible to create a plot using categorical variables
+# It is also possible to create a plot using categorical variables.
 # Matplotlib allows you to pass categorical variables directly to
 # many plotting functions. For example:
 
diff --git a/tutorials/01_introductory/sample_plots.py b/tutorials/01_introductory/sample_plots.py
@@ -11,7 +11,7 @@
 Line Plot
 =========
 
-Here's now to create a line plot with  text labels using
+Here's how to create a line plot with  text labels using
 :func:`~matplotlib.pyplot.plot`.
 
 .. figure:: ../../gallery/pylab_examples/images/sphx_glr_simple_plot_001.png
@@ -57,7 +57,7 @@
 Path demo
 =========
 
-You can add other paths in matplotlib using the
+You can add arbitrary paths in Matplotlib using the
 :mod:`matplotlib.path` module:
 
 .. figure:: ../../gallery/shapes_and_collections/images/sphx_glr_path_patch_001.png
@@ -84,7 +84,7 @@
    Surface3d
 
 Thanks to John Porter, Jonathon Taylor, Reinier Heeres, and Ben Root for
-the `mplot3d` toolkit. This toolkit is included with all standard matplotlib
+the `mplot3d` toolkit. This toolkit is included with all standard Matplotlib
 installs.
 
 .. _screenshots_ellipse_demo:
@@ -115,7 +115,7 @@
 
 In support of the
 `Phoenix <http://www.jpl.nasa.gov/news/phoenix/main.php>`_ mission to
-Mars (which used matplotlib to display ground tracking of spacecraft),
+Mars (which used Matplotlib to display ground tracking of spacecraft),
 Michael Droettboom built on work by Charlie Moad to provide an extremely
 accurate  8-spline approximation to elliptical arcs (see
 :class:`~matplotlib.patches.Arc`), which are insensitive to zoom level.
@@ -242,8 +242,8 @@
 Date demo
 =========
 
-You can plot date data with major and minor ticks and custom tick formatters
-for both.
+You can plot timeseries data with major and minor ticks and custom
+tick formatters for both.
 
 .. figure:: ../../gallery/api/images/sphx_glr_date_001.png
    :target: ../../gallery/api/date.html
@@ -313,7 +313,7 @@
 Mathtext_examples
 =================
 
-Below is a sampling of the many TeX expressions now supported by matplotlib's
+Below is a sampling of the many TeX expressions now supported by Matplotlib's
 internal mathtext engine.  The mathtext module provides TeX style mathematical
 expressions using `FreeType <https://www.freetype.org/>`_
 and the DejaVu, BaKoMa computer modern, or `STIX <http://www.stixfonts.org>`_
@@ -336,7 +336,7 @@
 Native TeX rendering
 ====================
 
-Although matplotlib's internal math rendering engine is quite
+Although Matplotlib's internal math rendering engine is quite
 powerful, sometimes you need TeX. Matplotlib supports external TeX
 rendering of strings with the *usetex* option.
 
@@ -352,7 +352,7 @@
 EEG demo
 =========
 
-You can embed matplotlib into pygtk, wx, Tk, or Qt applications.
+You can embed Matplotlib into pygtk, wx, Tk, or Qt applications.
 Here is a screenshot of an EEG viewer called `pbrain
 <https://github.com/nipy/pbrain>`__.
 
@@ -361,7 +361,7 @@
 The lower axes uses :func:`~matplotlib.pyplot.specgram`
 to plot the spectrogram of one of the EEG channels.
 
-For examples of how to embed matplotlib in different toolkits, see:
+For examples of how to embed Matplotlib in different toolkits, see:
 
    * :ref:`sphx_glr_gallery_user_interfaces_embedding_in_gtk2_sgskip.py`
    * :ref:`sphx_glr_gallery_user_interfaces_embedding_in_wx2_sgskip.py`
@@ -372,7 +372,7 @@
 XKCD-style sketch plots
 =======================
 
-matplotlib supports plotting in the style of `xkcd
+Matplotlib supports plotting in the style of `xkcd
 <http://www.xkcd.com/>`.
 
 .. figure:: ../../gallery/showcase/images/sphx_glr_xkcd_001.png

Original file line number	Diff line number	Diff line change
`@@ -124,7 +124,7 @@`
`124`	`124`	`# Plotting with categorical variables`
`125`	`125`	`# ===================================`
`126`	`126`	`#`
`127`		`-# It is also possible to create a plot using categorical variables`
	`127`	`+# It is also possible to create a plot using categorical variables.`
`128`	`128`	`# Matplotlib allows you to pass categorical variables directly to`
`129`	`129`	`# many plotting functions. For example:`
`130`	`130`