style_guide.rst table fix

jeromefv · jeromefv · commit 9be5d269ab74 · 2020-12-23T20:44:37.000-08:00
getting_started.py language clarifications
diff --git a/doc/devel/style_guide.rst b/doc/devel/style_guide.rst
@@ -22,17 +22,18 @@ not interchangeable.
 +------------------+--------------------------+--------------+--------------+
 | Term             | Description              | Correct      | Incorrect    |
 +==================+==========================+==============+==============+
-| Figure_          | Matplotlib working space |- One Figure  |- One figure  |
-|                  | for programming.         |- 11 Figures  |- 11 figures  |
+| Figure_          | Matplotlib working space | - One Figure | - One figure |
+|                  | for programming.         | - 11 Figures | - 11 figures |
 +------------------+--------------------------+--------------+--------------+
 | Axes_            | Subplots within Figure.  | - One Axes   | - One axes   |
 |                  | Contains Figure elements | - Four Axes  | - Four Axeses|
 |                  | and is responsible for   | - 32 Axes    | - 32 Axii    |
 |                  | plotting and configuring |              |              |
 |                  | additional details.      |              |              |
 +------------------+--------------------------+--------------+--------------+
-| Artist_          | Broad Matplotlib object  | - One Artist | - One artist |
-|                  | that displays visuals.   | - Two Artists| - Two artists|
+| Artist_          | Broad variety of         | - One Artist | - One artist |
+|                  | Matplotlib objects that  | - Two Artists| - Two artists|
+|                  | display visuals.         |              |              |
 +------------------+--------------------------+--------------+--------------+
 | Axis_            | Human-readable single    | - One Axis   | - One Axis   |
 |                  | dimensional object       |   object     | - One axis   |
@@ -145,7 +146,6 @@ reStructuredText standards
 - `reStructuredText Specifications <https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html>`_
 - `Quick Reference Document <https://docutils.sourceforge.io/docs/user/rst/quickref.html>`_
 
-
 Lists
 ^^^^^
 Bulleted lists are for items that do not require sequencing. Numbered lists are
@@ -184,7 +184,7 @@ Markdown tables and the csv-table directive are not accepted.
 | | OK       | Not OK   |        |     | ------- | --------- |            |
 | +----------+----------+        |     | OK      | Not OK    |            |
 |                                |                                        |
-+--------------------------------+----------------------------------------|
++--------------------------------+----------------------------------------+
 | ::                             | ::                                     |
 |                                |                                        |
 |     +----------+----------+    |     .. csv-table::                     |
diff --git a/tutorials/introductory/getting_started.py b/tutorials/introductory/getting_started.py
@@ -229,10 +229,10 @@
 # Explicit: Object Oriented Programming (OOP)
 # --------------------------------------------
 #
-# Explicit programming for Matplotlib involves using a single instance of the
-# ``pyplot`` module. This unpacks a set of an explicit Figure and Axes.
-# More than one Axes is configurable; however, each Axes only corresponds to a
-# single Figure.
+# Explicit programming for Matplotlib involves calling the method ``subplots``
+# in the ``pyplot`` module once. This unpacks a group of an explicit Figure and
+# Axes. More than one Axes is configurable; however, each Axes only corresponds
+# to a single Figure.
 #
 # Each Axes has its own methods to graph data. In addition, each Axes
 # also uses separate methods to create and manage parts of a Figure. These
@@ -410,7 +410,7 @@
 # +=======================+==========================+========================+
 # | Visible elements from | Each specific Axes has   | The ``pyplot`` module  |
 # | rendered Figure.      | its own method for       | manages Artists based  |
-# |                       | artists.                 | on most recent Figure  |
+# |                       | Artists.                 | on most recent Figure  |
 # |                       |                          | or Axes.               |
 # +-----------------------+--------------------------+------------------------+
 #
@@ -655,7 +655,7 @@ def autopct_format(percent, group):
                     # a percentage of the radius to place labels.
                     wedgeprops=dict(width=0.3),
                     # The wedgeprops keyword argument also takes dictionaries
-                    # to pass on to the artists. The float for width sets the
+                    # to pass on to the Artists. The float for width sets the
                     # wedge size as a percentage of the radius starting from
                     # the outer edge.
                     shadow=True)
@@ -703,8 +703,8 @@ def autopct_format(percent, group):
 #   argument is provided, the data acting as a percentage equivalent. The
 #   ``autopct_format`` function requires two arguments, so ``partial`` takes
 #   the argument for ``group`` and sets it to ``budget``. This smaller
-#   signature object then behaves as a function with one fewer argument. For
-#   details about the functools module, see
+#   signature object then behaves as the same function with one fewer argument.
+#   For details about the functools module, see
 #   `functools
 #   <https://docs.python.org/3/library/functools.html#module-functools>`_.
 #
