DOC: Improve what the axis= kwarg does for generic methods

- Fix #29203

Author: hongshaoyang

pandas/core/generic.py

@@ -10433,7 +10433,7 @@ def _add_numeric_operations(cls):
 
         @doc(
             desc="Return the mean absolute deviation of the values "
-            "for the requested axis.",
+            "across the requested axis.",
             name1=name1,
             name2=name2,
             axis_descr=axis_descr,
@@ -10560,7 +10560,7 @@ def mad(self, axis=None, skipna=None, level=None):
             name1=name1,
             name2=name2,
             axis_descr=axis_descr,
-            desc="Return the sum of the values for the requested axis.\n\n"
+            desc="Return the sum of the values across the requested axis.\n\n"
             "This is equivalent to the method ``numpy.sum``.",
             func=nanops.nansum,
             see_also=_stat_func_see_also,
@@ -10572,7 +10572,7 @@ def mad(self, axis=None, skipna=None, level=None):
             name1=name1,
             name2=name2,
             axis_descr=axis_descr,
-            desc="Return the mean of the values for the requested axis.",
+            desc="Return the mean of the values across the requested axis.",
             func=nanops.nanmean,
         )
         cls.skew = _make_stat_function(
@@ -10603,7 +10603,7 @@ def mad(self, axis=None, skipna=None, level=None):
             name1=name1,
             name2=name2,
             axis_descr=axis_descr,
-            desc="Return the product of the values for the requested axis.",
+            desc="Return the product of the values across the requested axis.",
             func=nanops.nanprod,
             examples=_prod_examples,
         )
@@ -10614,7 +10614,7 @@ def mad(self, axis=None, skipna=None, level=None):
             name1=name1,
             name2=name2,
             axis_descr=axis_descr,
-            desc="Return the median of the values for the requested axis.",
+            desc="Return the median of the values across the requested axis.",
             func=nanops.nanmedian,
         )
         cls.max = _make_stat_function(
@@ -10623,7 +10623,7 @@ def mad(self, axis=None, skipna=None, level=None):
             name1=name1,
             name2=name2,
             axis_descr=axis_descr,
-            desc="Return the maximum of the values for the requested axis.\n\n"
+            desc="Return the maximum of the values across the requested axis.\n\n"
             "If you want the *index* of the maximum, use ``idxmax``. This is"
             "the equivalent of the ``numpy.ndarray`` method ``argmax``.",
             func=nanops.nanmax,
@@ -10636,7 +10636,7 @@ def mad(self, axis=None, skipna=None, level=None):
             name1=name1,
             name2=name2,
             axis_descr=axis_descr,
-            desc="Return the minimum of the values for the requested axis.\n\n"
+            desc="Return the minimum of the values across the requested axis.\n\n"
             "If you want the *index* of the minimum, use ``idxmin``. This is"
             "the equivalent of the ``numpy.ndarray`` method ``argmin``.",
             func=nanops.nanmin,