DOC: Add links to patch Artists and improve phrasing

melissawm · melissawm · commit 5a9d0e30cde6 · 2023-05-22T19:34:20.000-03:00
diff --git a/galleries/users_explain/quick_start.py b/galleries/users_explain/quick_start.py
@@ -563,10 +563,12 @@ def my_plotter(ax, data1, data2, param_dict):
 # Patches
 # =======
 #
-# Patches are Artists with a face color and an edge color, which can be used to
-# draw arbitrary two dimensional regions. In addition to the more general
-# Polygon, there are wrappers and helpers for common shapes like Rectangles,
-# Circles, Boxes, Ellipses, and more.
+# :mod:`Patches <matplotlib.patches>` are a family of Artists that can be used
+# when drawing arbitrary two-dimensional regions. In addition to the general
+# Patch Artists :class:`~.patches.PathPatch` and :class:`~.patches.Polygon`,
+# common shapes have corresponding Patch Artists such as
+# :class:`~.patches.Circle`, :class:`~.patches.Rectangle`,
+# :class:`~.patches.Ellipse`, etc.
 
 fig, ax = plt.subplots()
 
