pandas-dev#28792 DOC: udpated reviewers comments

Author: nagesh-chowdaiah

pandas/_libs/tslibs/timedeltas.pyx

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

pandas/core/arrays/datetimes.py

@@ -1259,8 +1259,10 @@ def isocalendar(self):
 
         See Also
         --------
-        Timestamp.isocalendar
-        datetime.date.isocalendar
+        Timestamp.isocalendar : Function return a 3-tuple containing ISO year,
+            week number, and weekday for the given Timestamp object.
+        datetime.date.isocalendar : Return a named tuple object with
+            three components: year, week and weekday.
 
         Examples
         --------

pandas/core/dtypes/base.py

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

pandas/core/groupby/groupby.py

@@ -81,7 +81,7 @@ class providing the base-class of operations.
         --------
         Series.%(name)s : Apply a function %(name)s to a Series.
         DataFrame.%(name)s : Apply a function %(name)s
-         to each row or column of a DataFrame.
+            to each row or column of a DataFrame.
 """
 
 _apply_docs = dict(
@@ -320,11 +320,11 @@ class providing the base-class of operations.
 See Also
 --------
 %(klass)s.groupby.apply : Apply function func group-wise
- and combine the results together.
+    and combine the results together.
 %(klass)s.groupby.aggregate : Aggregate using one or more
- operations over the specified axis.
+    operations over the specified axis.
 %(klass)s.transform : Transforms the Series on each group
- based on the given function.
+    based on the given function.
 
 Notes
 -----
@@ -432,11 +432,11 @@ class providing the base-class of operations.
 See Also
 --------
 {klass}.groupby.apply : Apply function func group-wise
- and combine the results together.
+    and combine the results together.
 {klass}.groupby.transform : Aggregate using one or more
- operations over the specified axis.
+    operations over the specified axis.
 {klass}.aggregate : Transforms the Series on each group
- based on the given function.
+    based on the given function.
 
 Notes
 -----

pandas/core/indexes/accessors.py

@@ -236,8 +236,10 @@ def isocalendar(self):
 
         See Also
         --------
-        Timestamp.isocalendar
-        datetime.date.isocalendar
+        Timestamp.isocalendar : Function return a 3-tuple containing ISO year, week number,
+            and weekday for the given Timestamp object.
+        datetime.date.isocalendar : Return a named tuple object with
+            three components: year, week and weekday.
 
         Examples
         --------
@@ -327,7 +329,7 @@ def to_pytimedelta(self) -> np.ndarray:
         See Also
         --------
         datetime.timedelta : A duration expressing the difference
-         between two date, time, or datetime.
+            between two date, time, or datetime.
 
         Examples
         --------

pandas/core/indexes/base.py

@@ -706,7 +706,7 @@ def astype(self, dtype, copy=True):
         See Also
         --------
         numpy.ndarray.take: Return an array formed from the
-         elements of a at the given indices.
+            elements of a at the given indices.
         """
 
     @Appender(_index_shared_docs["take"] % _index_doc_kwargs)
@@ -3939,7 +3939,7 @@ def _values(self) -> Union[ExtensionArray, np.ndarray]:
 
         See Also
         --------
-        values
+        values : Values
         """
         return self._data
 
@@ -4231,7 +4231,7 @@ def putmask(self, mask, value):
         See Also
         --------
         numpy.ndarray.putmask : Changes elements of an array
-         based on conditional and input values.
+            based on conditional and input values.
         """
         values = self.values.copy()
         try:

pandas/core/resample.py

@@ -236,11 +236,11 @@ def pipe(self, func, *args, **kwargs):
     See Also
     --------
     DataFrame.groupby.aggregate : Aggregate using callable, string, dict,
-            or list of string/callables.
+        or list of string/callables.
     DataFrame.resample.transform : Transforms the Series on each group
-            based on the given function.
+        based on the given function.
     DataFrame.aggregate: Aggregate using one or more
-            operations over the specified axis.
+        operations over the specified axis.
     """
     )
 

pandas/io/formats/style.py

@@ -830,7 +830,7 @@ def applymap(self, func: Callable, subset=None, **kwargs) -> "Styler":
         See Also
         --------
         Styler.where: Updates the HTML representation with a style which is
-         selected in accordance with the return value of a function.
+            selected in accordance with the return value of a function.
         """
         self._todo.append(
             (lambda instance: getattr(instance, "_applymap"), (func, subset), kwargs)