DOC: Fix SA04 errors in docstrings xref #28792

pandas/core/algorithms.py

@@ -313,8 +313,8 @@ def unique(values):
 
     See Also
     --------
-    Index.unique
-    Series.unique
+    Index.unique  : Return Index with unique values from an Index object.
+    Series.unique : Return unique values of Series object.
 
     Examples
     --------
@@ -1515,7 +1515,7 @@ def take(arr, indices, axis: int = 0, allow_fill: bool = False, fill_value=None)
 
     See Also
     --------
-    numpy.take
+    numpy.take : Take elements from an array along an axis.
 
     Examples
     --------

pandas/core/frame.py

@@ -358,9 +358,9 @@ class DataFrame(NDFrame):
     --------
     DataFrame.from_records : Constructor from tuples, also record arrays.
     DataFrame.from_dict : From dicts of Series, arrays, or dicts.
-    read_csv
-    read_table
-    read_clipboard
+    read_csv : Read a comma-separated values (csv) file into DataFrame.
+    read_table : Read general delimited file into DataFrame.
+    read_clipboard : Read text from clipboard and pass to read_table.
 
     Examples
     --------
@@ -7292,8 +7292,9 @@ def corr(self, method="pearson", min_periods=1) -> "DataFrame":
 
         See Also
         --------
-        DataFrame.corrwith
-        Series.corr
+        DataFrame.corrwith : Compute pairwise correlation between rows or
+            columns of two DataFrame objects.
+        Series.corr : Compute the correlation between two Series.
 
         Examples
         --------
@@ -7495,7 +7496,7 @@ def corrwith(self, other, axis=0, drop=False, method="pearson") -> Series:
 
         See Also
         --------
-        DataFrame.corr
+        DataFrame.corr : Compute pairwise correlation of columns.
         """
         axis = self._get_axis_number(axis)
         this = self._get_numeric_data()
@@ -7900,7 +7901,8 @@ def idxmin(self, axis=0, skipna=True) -> Series:
 
         See Also
         --------
-        Series.idxmin
+        Series.idxmin : Return index *label* of the first occurrence
+            of minimum of values.
 
         Notes
         -----
@@ -7938,7 +7940,8 @@ def idxmax(self, axis=0, skipna=True) -> Series:
 
         See Also
         --------
-        Series.idxmax
+        Series.idxmax : Return index *label* of the first occurrence
+            of maximum of values.
 
         Notes
         -----

pandas/core/series.py

@@ -552,7 +552,7 @@ def ravel(self, order="C"):
 
         See Also
         --------
-        numpy.ndarray.ravel
+        numpy.ndarray.ravel : Return a flattened array.
         """
         return self._values.ravel(order=order)
 
@@ -2074,6 +2074,9 @@ def round(self, decimals=0, *args, **kwargs) -> "Series":
         decimals : int, default 0
             Number of decimal places to round to. If decimals is negative,
             it specifies the number of positions to the left of the decimal point.
+        *args, **kwargs
+            Additional arguments and keywords have no effect but might be
+            accepted for compatibility with NumPy.
 
         Returns
         -------
@@ -2128,8 +2131,8 @@ def quantile(self, q=0.5, interpolation="linear"):
 
         See Also
         --------
-        core.window.Rolling.quantile
-        numpy.percentile
+        core.window.Rolling.quantile : Calculate the %(name)s quantile.
+        numpy.percentile : Returns the q-th percentile(s) of the array elements.
 
         Examples
         --------
@@ -3147,7 +3150,7 @@ def argsort(self, axis=0, kind="quicksort", order=None) -> "Series":
 
         See Also
         --------
-        numpy.ndarray.argsort
+        numpy.ndarray.argsort : Returns the indices that would sort this array.
         """
         values = self._values
         mask = isna(values)