DOC: strongly suggest to use clear instead

tacaswell · timhoffm · tacaswell · commit 3587b8ba4252 · 2022-04-05T13:23:41.000-04:00
Co-authored-by: Tim Hoffmann &lt;2836374+timhoffm@users.noreply.github.com&gt;
diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
@@ -954,6 +954,10 @@ def clf(self, keep_observers=False):
         """
         Alias for the `clear()` method.
 
+        .. admonition:: Discouraged
+
+            The use of ``clf()`` is discouraged. Use ``clear()`` instead.
+
         Parameters
         ----------
         keep_observers: bool, default: False
