matplotlib
diff --git a/‎galleries/tutorials/index.rst
Lines changed: 43 additions & 54 deletions b/‎galleries/tutorials/index.rst
Lines changed: 43 additions & 54 deletions
diff --git a/‎galleries/examples/pie_and_polar_charts/pie_and_donut_labels.py renamed to ‎galleries/tutorials/pie_and_donut_labels.py
Lines changed: 5 additions & 0 deletions b/‎galleries/examples/pie_and_polar_charts/pie_and_donut_labels.py renamed to ‎galleries/tutorials/pie_and_donut_labels.py
Lines changed: 5 additions & 0 deletions
@@ -3,17 +3,32 @@
 Tutorials
 =========
 
-This page contains a few tutorials for using Matplotlib.  For the old tutorials, see :ref:`below <user_guide_tutorials>`.
+Walk-throughs of building visualizations that incorporate multiple features of the
+library.
+
+
+.. attention::
+
+   We're re-organizing! Please nominate :ref:`examples <examples-index>` that you think are good
+   tutorials and propose new ones by opening an
+   :ref:`issue or pull request <
10000
;contribute_documentation>`!
+
+   If you are unsure of what we consider a tutorial, see our
+   :ref:`content guide <content-tutorials>` and ask on our
+   :ref:`communication <communication-channels>`
+
+
+To learn more about Matplotlib, see the :ref:`user guide <users-guide-index>` and
+:ref:`community resources  <resources-index>`. For examples, see the
+:ref:`examples-index` gallery.
 
-For shorter examples, see our :ref:`examples page <examples-index>`.
-You can also find :ref:`external resources <resources-index>` and
-a :ref:`FAQ <faq-index>` in our :ref:`user guide <users-guide-index>`.
 
 
 .. raw:: html
 
     <div class="sphx-glr-thumbnails">
 
+.. pyplot tutorial
 
 .. raw:: html
 
@@ -31,6 +46,7 @@ a :ref:`FAQ <faq-index>` in our :ref:`user guide <users-guide-index>`.
       <div class="sphx-glr-thumbnail-title">Pyplot tutorial</div>
     </div>
 
+.. images
 
 .. raw:: html
 
@@ -49,6 +65,8 @@ a :ref:`FAQ <faq-index>` in our :ref:`user guide <users-guide-index>`.
     </div>
 
 
+.. lifecycle
+
 .. raw:: html
 
     <div class="sphx-glr-thumbcontainer" tooltip="This tutorial aims to show the beginning, middle, and end of a single visualization using Matpl...">
@@ -65,6 +83,7 @@ a :ref:`FAQ <faq-index>` in our :ref:`user guide <users-guide-index>`.
       <div class="sphx-glr-thumbnail-title">The Lifecycle of a Plot</div>
     </div>
 
+.. artist
 
 .. raw:: html
 
@@ -83,6 +102,25 @@ a :ref:`FAQ <faq-index>` in our :ref:`user guide <users-guide-index>`.
     </div>
 
 
+.. annotation
+
+.. raw:: html
+
+    <div class="sphx-glr-thumbcontainer" tooltip="Labeling pie and donut charts.">
+
+.. only:: html
+
+  .. image:: /tutorials/images/thumb/sphx_glr_pie_and_donut_labels_thumb.png
+    :alt: Labeling and annotating pie and donut charts.
+
+  :ref:`sphx_glr_tutorials_pie_and_donut_labels.py`
+
+.. raw:: html
+
+      <div class="sphx-glr-thumbnail-title">Labeling a pie and a donut</div>
+    </div>
+
+
 .. raw:: html
 
     </div>
@@ -95,6 +133,7 @@ a :ref:`FAQ <faq-index>` in our :ref:`user guide <users-guide-index>`.
    /tutorials/images
    /tutorials/lifecycle
    /tutorials/artists
+   /tutorials/pie_and_donut_labels
 
 .. only:: html
 
@@ -107,53 +146,3 @@ a :ref:`FAQ <faq-index>` in our :ref:`user guide <users-guide-index>`.
     .. container:: sphx-glr-download sphx-glr-download-jupyter
 
       :download:`Download all examples in Jupyter notebooks: tutorials_jupyter.zip </tutorials/tutorials_jupyter.zip>`
-
-
-
-.. _user_guide_tutorials:
-
-User guide tutorials
---------------------
-
-Many of our tutorials were moved from this section to :ref:`users-guide-index`:
-
-Introductory
-^^^^^^^^^^^^
-
-- :ref:`quick_start`
-- :ref:`customizing`
-- :ref:`animations`
-
-Intermediate
-^^^^^^^^^^^^
-
-- :ref:`legend_guide`
-- :ref:`color_cycle`
-- :ref:`constrainedlayout_guide`
-- :ref:`tight_layout_guide`
-- :ref:`arranging_axes`
-- :ref:`autoscale`
-- :ref:`imshow_extent`
-
-Advanced
-^^^^^^^^
-
-- :ref:`blitting`
-- :ref:`paths`
-- :ref:`patheffects_guide`
-- :ref:`transforms_tutorial`
-
-Colors
-^^^^^^
-
-See :ref:`tutorials-colors`.
-
-Text
-^^^^
-
-See :ref:`tutorials-text`.
-
-Toolkits
-^^^^^^^^
-
-See :ref:`tutorials-toolkits`.
@@ -1,4 +1,8 @@
 """
+.. redirect-from:: /gallery/pie_and_polar_charts/pie_and_donut_labels
+
+.. _pie_donut_labels:
+
 ==========================
 Labeling a pie and a donut
 ==========================
@@ -122,6 +126,7 @@ def func(pct, allvals):
 # the ingredients would suffice for around 6 donuts - producing one huge
 # donut is untested and might result in kitchen errors.
 
+# .. tags:: plot-type: pie, component: annotation, level: beginner
 
 # %%
 #