Backport PR #26317: update the doc string for fancyarrowpatch to link to annotate

marbled-toast · meeseeksmachine · commit bce5be87f4c0 · 2023-07-15T19:41:33.000Z
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
@@ -4029,7 +4029,11 @@ def get_bbox(self):
 
 class FancyArrowPatch(Patch):
     """
-    A fancy arrow patch. It draws an arrow using the `ArrowStyle`.
+    A fancy arrow patch.
+
+    It draws an arrow using the `ArrowStyle`. It is primarily used by the
+    `~.axes.Axes.annotate` method.  For most purposes, use the annotate method for
+    drawing arrows.
 
     The head and tail positions are fixed at the specified start and end points
     of the arrow, but the size and shape (in display coordinates) of the arrow
