Jan 11, 2024
diff --git a/galleries/tutorials/index.rst b/galleries/tutorials/index.rst
 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 <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

      <div class="sphx-glr-thumbnail-title">Pyplot tutorial</div>
    </div>

 .. images

 .. raw:: html

    </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...">
      <div class="sphx-glr-thumbnail-title">The Lifecycle of a Plot</div>
    </div>

 .. artist

 .. raw:: html

    </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>
   /tutorials/images
   /tutorials/lifecycle
   /tutorials/artists
   /tutorials/pie_and_donut_labels

 .. only:: html

    .. 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`.
diff --git a/..._and_polar_charts/pie_and_donut_labels.py → galleries/tutorials/pie_and_donut_labels.py b/..._and_polar_charts/pie_and_donut_labels.py → galleries/tutorials/pie_and_donut_labels.py
 """
 .. redirect-from:: /gallery/pie_and_polar_charts/pie_and_donut_labels

 .. _pie_donut_labels:

 ==========================
 Labeling a pie and a donut
 ==========================
 # 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

 # %%
 #
Original file line number	Diff line number	Diff line change
Expand Up		@@ -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 <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

Expand All		@@ -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

Expand All		@@ -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...">
Expand All		@@ -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

Expand All		@@ -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>
Expand All		@@ -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

Expand All		@@ -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`.
Original file line number	Diff line number	Diff line change
		@@ -1,4 +1,8 @@
		"""
		.. redirect-from:: /gallery/pie_and_polar_charts/pie_and_donut_labels

		.. _pie_donut_labels:

		==========================
		Labeling a pie and a donut
		==========================
Expand DownExpand Up		@@ -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

		# %%
		#
Expand Down