DOC: rename usage tutorial to quick_start

Author: jklymak

.flake8

@@ -100,7 +100,7 @@ per-file-ignores =
     tutorials/introductory/images.py: E402, E501
     tutorials/introductory/pyplot.py: E402, E501
     tutorials/introductory/sample_plots.py: E501
-    tutorials/introductory/usage.py: E703
+    tutorials/introductory/quick_start.py: E703
     tutorials/text/annotations.py: E402, E501
     tutorials/text/text_intro.py: E402
     tutorials/text/text_props.py: E501

doc/devel/documenting_mpl.rst

@@ -199,15 +199,15 @@ Documents can be linked with the ``:doc:`` directive:
 
    See the :doc:`/users/installing/index`
 
-   See the tutorial :doc:`/tutorials/introductory/usage`
+   See the tutorial :doc:`/tutorials/introductory/quick_start`
 
    See the example :doc:`/gallery/lines_bars_and_markers/simple_plot`
 
 will render as:
 
   See the :doc:`/users/installing/index`
 
-  See the tutorial :doc:`/tutorials/introductory/usage`
+  See the tutorial :doc:`/tutorials/introductory/quick_start`
 
   See the example :doc:`/gallery/lines_bars_and_markers/simple_plot`
 
@@ -847,7 +847,7 @@ render as comments in :doc:`/gallery/lines_bars_and_markers/simple_plot`.
 
 Tutorials are made with the exact same mechanism, except they are longer, and
 typically have more than one comment block (i.e.
-:doc:`/tutorials/introductory/usage`).  The first comment block
+:doc:`/tutorials/introductory/quick_start`).  The first comment block
 can be the same as the example above.  Subsequent blocks of ReST text
 are delimited by a line of ``###`` characters:
 

doc/index.rst

@@ -46,7 +46,7 @@ Learning resources
     Tutorials
     ^^^^^^^^^
 
-    - :doc:`Quick-start guide <tutorials/introductory/usage>`
+    - :doc:`Quick-start guide <tutorials/introductory/quick_start>`
     - :doc:`Plot types <plot_types/index>`
     - `Introductory tutorials <../tutorials/index.html#introductory>`_
     - :doc:`External learning resources <users/resources/index>`

doc/users/getting_started/index.rst

@@ -44,12 +44,12 @@ Here is a minimal example plot:
    ax.plot(x, y)
    plt.show()
 
-If a plot does not show up please check :ref:`troubleshooting-faq`.  
+If a plot does not show up please check :ref:`troubleshooting-faq`.
 
 Where to go next
 ----------------
 
 - Check out :doc:`Plot types </plot_types/index>` to get an overview of the
   types of plots you can create with Matplotlib.
 - Learn Matplotlib from the ground up in the
-  :doc:`Quick-start guide </tutorials/introductory/usage>`.
+  :doc:`Quick-start guide </tutorials/introductory/quick_start>`.

tutorials/introductory/images.py

@@ -43,8 +43,8 @@
 settings.  The alternative is the object-oriented interface, which is also
 very powerful, and generally more suitable for large application
 development.  If you'd like to learn about the object-oriented
-interface, a great place to start is our :doc:`Usage guide
-</tutorials/introductory/usage>`.  For now, let's get on
+interface, a great place to start is our :doc:`Quick start guide
+</tutorials/introductory/quick_start>`.  For now, let's get on
 with the imperative-style approach:
 """
 

tutorials/introductory/pyplot.py

@@ -3,7 +3,8 @@
 Pyplot tutorial
 ===============
 
-An introduction to the pyplot interface.
+An introduction to the pyplot interface.  Please also see
+:doc:`/tutorials/introductory/quick_start` for an overview of how Matplotlib works.
 """
 
 ###############################################################################

tutorials/introductory/usage.py tutorials/introductory/quick_start.pytutorials/introductory/usage.py renamed to tutorials/introductory/quick_start.py

@@ -1,10 +1,13 @@
 """
-***********
-Basic Usage
-***********
+*****************
+Quick start guide
+*****************
 
 This tutorial covers some basic usage patterns and best practices to
 help you get started with Matplotlib.
+
+.. redirect-from:: /tutorials/introductory/usage
+
 """
 
 # sphinx_gallery_thumbnail_number = 3