Apply suggestion from @timhoffm

rcomer · timhoffm · web-flow · commit d35aaea6fd6b · 2026-03-29T16:53:09.000+01:00
Co-authored-by: Tim Hoffmann &lt;2836374+timhoffm@users.noreply.github.com&gt;
diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
@@ -1176,10 +1176,13 @@ def set_position(self, pos, which='both'):
             Determines which position variables to change.
 
             .. note::
+                This parameter is considered internal. End users should not use it.
+
                 For native Matplotlib `.Axes`, the active position is
                 determined by a combination of the original position and the
-                aspect ratio.  Setting the active position directly is
-                therefore not effective.  This option is retained as it may be
+                aspect ratio.  Setting the active position only is only meaningful
+                in the context of correct internal state, which is managed
+                internally inside `.Axes`. This option is retained as it may be
                 relevant for some third party `.Axes` subclasses.
 
         See Also
