Reword note on legend handlers

timhoffm · timhoffm · commit 1a86a71dbbd8 · 2021-06-01T07:33:57.000+02:00
diff --git a/lib/matplotlib/legend_handler.py b/lib/matplotlib/legend_handler.py
@@ -3,8 +3,10 @@
 
 .. important::
 
-    It is strongly encouraged to have read the :doc:`legend guide
-    </tutorials/intermediate/legend_guide>` before this documentation.
+    This is a low-level legend API, which most end users do not need.
+
+    We recommend that you are familiar with the :doc:`legend guide
+    </tutorials/intermediate/legend_guide>` before reading this documentation.
 
 Legend handlers are expected to be a callable object with a following
 signature. ::
