Tweak secondary_{x,y}axis docs.

anntzer · anntzer · commit b3d6379b485c · 2026-03-27T19:10:35.000+01:00
Use a full sentence with a principal clause.  Also, the data is not
plotted on the x- or y-axis; it is the scale that is on the x- or
y-axis.
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
 
