Merge pull request #31405 from anntzer/saxd

QuLogic · web-flow · commit 30c3d786fe93 · 2026-03-27T23:58:19.000-04:00
Tweak secondary_{x,y}axis docs.
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -556,8 +556,8 @@ def secondary_xaxis(self, location, functions=None, *, transform=None, **kwargs)
         """
         Add a second x-axis to this `~.axes.Axes`.
 
-        For example if we want to have a second scale for the data plotted on
-        the xaxis.
+        This axis is typically used to display a second x-scale for the data
+        plotted on the Axes.
 
         %(_secax_docstring)s
 
@@ -610,8 +610,8 @@ def secondary_yaxis(self, location, functions=None, *, transform=None, **kwargs)
         """
         Add a second y-axis to this `~.axes.Axes`.
 
-        For example if we want to have a second scale for the data plotted on
-        the yaxis.
+        This axis is typically used to display a second y-scale for the data
+        plotted on the Axes.
 
         %(_secax_docstring)s
 
