pandas-dev#28792 DOC: Fixed SA04 Errors

Author: nagesh-chowdaiah

pandas/_libs/tslibs/timedeltas.pyx

@@ -1056,7 +1056,8 @@ cdef class _Timedelta(timedelta):
 
         See Also
         --------
-        Timestamp.isoformat
+        Timestamp.isoformat : function is used to convert the given
+         Timestamp object into the ISO format.
 
         Notes
         -----

pandas/core/arrays/base.py

@@ -232,8 +232,8 @@ def _from_factorized(cls, values, original):
 
         See Also
         --------
-        factorize
-        ExtensionArray.factorize
+        factorize : Top-level factorize method that dispatches here.
+        ExtensionArray.factorize : Encode the extension array as an enumerated type.
         """
         raise AbstractMethodError(cls)
 
@@ -501,7 +501,7 @@ def _values_for_argsort(self) -> np.ndarray:
 
         See Also
         --------
-        ExtensionArray.argsort
+        ExtensionArray.argsort : Return the indices that would sort this array.
         """
         # Note: this is used in `ExtensionArray.argsort`.
         return np.array(self)
@@ -956,8 +956,8 @@ def take(
 
         See Also
         --------
-        numpy.take
-        api.extensions.take
+        numpy.take : Take elements from an array along an axis.
+        api.extensions.take : Take elements from an array.
 
         Notes
         -----

pandas/core/arrays/boolean.py

@@ -418,7 +418,7 @@ def _values_for_argsort(self) -> np.ndarray:
 
         See Also
         --------
-        ExtensionArray.argsort
+        ExtensionArray.argsort: Return the indices that would sort this array.
         """
         data = self._data.copy()
         data[self._mask] = -1

pandas/core/arrays/categorical.py

@@ -2061,7 +2061,7 @@ def unique(self):
         --------
         pandas.unique
         CategoricalIndex.unique
-        Series.unique
+        Series.unique : Return unique values of Series object.
 
         Examples
         --------

pandas/core/arrays/integer.py

@@ -484,7 +484,7 @@ def _values_for_argsort(self) -> np.ndarray:
 
         See Also
         --------
-        ExtensionArray.argsort
+        ExtensionArray.argsort: Return the indices that would sort this array.
         """
         data = self._data.copy()
         if self._mask.any():

pandas/core/dtypes/base.py

@@ -21,8 +21,9 @@ class ExtensionDtype:
 
     See Also
     --------
-    extensions.register_extension_dtype
-    extensions.ExtensionArray
+    extensions.register_extension_dtype: Register an ExtensionType
+     with pandas as class decorator.
+    extensions.ExtensionArray: Abstract base class for custom 1-D array types.
 
     Notes
     -----

pandas/core/frame.py

@@ -586,7 +586,7 @@ def shape(self) -> Tuple[int, int]:
 
         See Also
         --------
-        ndarray.shape
+        ndarray.shape : Tuple of array dimensions.
 
         Examples
         --------

pandas/core/generic.py

@@ -257,7 +257,7 @@ def attrs(self) -> Dict[Optional[Hashable], Any]:
 
         See Also
         --------
-        DataFrame.flags
+        DataFrame.flags : Global flags applying to this object.
         """
         if self._attrs is None:
             self._attrs = {}
@@ -278,8 +278,8 @@ def flags(self) -> Flags:
 
         See Also
         --------
-        Flags
-        DataFrame.attrs
+        Flags : Flags that apply to pandas objects.
+        DataFrame.attrs : Global metadata applying to this dataset.
 
         Notes
         -----

pandas/core/groupby/groupby.py

@@ -319,9 +319,12 @@ class providing the base-class of operations.
 
 See Also
 --------
-%(klass)s.groupby.apply
-%(klass)s.groupby.aggregate
-%(klass)s.transform
+%(klass)s.groupby.apply : Apply function func group-wise
+ and combine the results together.
+%(klass)s.groupby.aggregate : Aggregate using one or more
+ operations over the specified axis.
+%(klass)s.transform : Transforms the Series on each group
+ based on the given function.
 
 Notes
 -----
@@ -428,9 +431,12 @@ class providing the base-class of operations.
 
 See Also
 --------
-{klass}.groupby.apply
-{klass}.groupby.transform
-{klass}.aggregate
+{klass}.groupby.apply : Apply function func group-wise
+ and combine the results together.
+{klass}.groupby.transform : Aggregate using one or more
+ operations over the specified axis.
+{klass}.aggregate : Transforms the Series on each group
+ based on the given function.
 
 Notes
 -----
@@ -1857,8 +1863,8 @@ def _fill(self, direction, limit=None):
 
         See Also
         --------
-        pad
-        backfill
+        pad : Returns Series with minimum number of char in object.
+        backfill : Backward fill the missing values in the dataset.
         """
         # Need int value for Cython
         if limit is None:
@@ -1892,10 +1898,10 @@ def pad(self, limit=None):
 
         See Also
         --------
-        Series.pad
-        DataFrame.pad
-        Series.fillna
-        DataFrame.fillna
+        Series.pad: Returns Series with minimum number of char in object.
+        DataFrame.pad: Object with missing values filled or None if inplace=True.
+        Series.fillna: Fill NaN values of a Series.
+        DataFrame.fillna: Fill NaN values of a DataFrame.
         """
         return self._fill("ffill", limit=limit)
 
@@ -1918,10 +1924,10 @@ def backfill(self, limit=None):
 
         See Also
         --------
-        Series.backfill
-        DataFrame.backfill
-        Series.fillna
-        DataFrame.fillna
+        Series.backfill :  Backward fill the missing values in the dataset.
+        DataFrame.backfill:  Backward fill the missing values in the dataset
+        Series.fillna: Fill NaN values of a Series.
+        DataFrame.fillna: Fill NaN values of a DataFrame.
         """
         return self._fill("bfill", limit=limit)
 

pandas/core/indexes/accessors.py

@@ -326,7 +326,8 @@ def to_pytimedelta(self) -> np.ndarray:
 
         See Also
         --------
-        datetime.timedelta
+        datetime.timedelta : A duration expressing the difference
+         between two date, time, or datetime.
 
         Examples
         --------

pandas/core/indexes/base.py

@@ -609,7 +609,7 @@ def ravel(self, order="C"):
 
         See Also
         --------
-        numpy.ndarray.ravel
+        numpy.ndarray.ravel : Return a flattened array.
         """
         warnings.warn(
             "Index.ravel returning ndarray is deprecated; in a future version "
@@ -705,7 +705,8 @@ def astype(self, dtype, copy=True):
 
         See Also
         --------
-        numpy.ndarray.take
+        numpy.ndarray.take: Return an array formed from the
+         elements of a at the given indices.
         """
 
     @Appender(_index_shared_docs["take"] % _index_doc_kwargs)
@@ -2298,8 +2299,8 @@ def unique(self, level=None):
 
         See Also
         --------
-        unique
-        Series.unique
+        unique : Numpy array of unique values in that column.
+        Series.unique : Return unique values of Series object.
         """
         if level is not None:
             self._validate_index_level(level)
@@ -4229,7 +4230,8 @@ def putmask(self, mask, value):
 
         See Also
         --------
-        numpy.ndarray.putmask
+        numpy.ndarray.putmask : Changes elements of an array
+         based on conditional and input values.
         """
         values = self.values.copy()
         try:

pandas/io/formats/style.py

@@ -829,7 +829,8 @@ def applymap(self, func: Callable, subset=None, **kwargs) -> "Styler":
 
         See Also
         --------
-        Styler.where
+        Styler.where: Updates the HTML representation with a style which is
+         selected in accordance with the return value of a function.
         """
         self._todo.append(
             (lambda instance: getattr(instance, "_applymap"), (func, subset), kwargs)
@@ -870,7 +871,7 @@ def where(
 
         See Also
         --------
-        Styler.applymap
+        Styler.applymap: Updates the HTML representation with the result.
         """
         if other is None:
             other = ""
@@ -930,7 +931,7 @@ def export(self) -> List[Tuple[Callable, Tuple, Dict]]:
 
         See Also
         --------
-        Styler.use
+        Styler.use: Set the styles on the current Styler.
         """
         return self._todo
 
@@ -951,7 +952,7 @@ def use(self, styles: List[Tuple[Callable, Tuple, Dict]]) -> "Styler":
 
         See Also
         --------
-        Styler.export
+        Styler.export : Export the styles to applied to the current Styler.
         """
         self._todo.extend(styles)
         return self