DOC: clarify wording

tacaswell · timhoffm · web-flow · commit d494c318707d · 2025-04-14T09:17:57.000-04:00
Co-authored-by: Tim Hoffmann &lt;2836374+timhoffm@users.noreply.github.com&gt;
diff --git a/lib/matplotlib/artist.py b/lib/matplotlib/artist.py
@@ -337,15 +337,14 @@ def get_window_extent(self, renderer=None):
 
         .. warning::
 
-          Be careful when using this function, the results will not update if
-          the artist window extent of the artist changes.
-
           The extent can change due to any changes in the transform stack, such
           as changing the Axes limits, the figure size, the canvas used (as is
           done when saving a figure), or the DPI.
 
-          This can lead to unexpected behavior where interactive figures will
-          look fine on the screen, but will save incorrectly.
+          Relying on a once-retrieved window extent can lead to unexpected
+          behavior in various cases such as interactive figures being resized or
+          moved to a screen with different dpi, or figures that look fine on
+          screen render incorrectly when saved to file.
 
           To get accurate results you may need to manually call
           `matplotlib.figure.Figure.savefig` or
