fixing

Author: alexander-ponomaroff

pandas/_libs/interval.pyx

@@ -158,16 +158,6 @@ cdef class Interval(IntervalMixin):
         Whether the interval is closed on the left-side, right-side, both or
         neither. See the Notes for more detailed explanation.
 
-    See Also
-    --------
-    IntervalIndex : An Index of Interval objects that are all closed on the
-        same side.
-    cut : Convert continuous data into discrete bins (Categorical
-        of Interval objects).
-    qcut : Convert continuous data into bins (Categorical of Interval objects)
-        based on quantiles.
-    Period : Represents a period of time.
-
     Notes
     -----
     The parameters `left` and `right` must be from the same type, you must be
@@ -236,6 +226,16 @@ cdef class Interval(IntervalMixin):
     >>> volume_1 = pd.Interval('Ant', 'Dog', closed='both')
     >>> 'Bee' in volume_1
     True
+
+    See Also
+    --------
+    IntervalIndex : An Index of Interval objects that are all closed on the
+        same side.
+    cut : Convert continuous data into discrete bins (Categorical
+        of Interval objects).
+    qcut : Convert continuous data into bins (Categorical of Interval objects)
+        based on quantiles.
+    Period : Represents a period of time.
     """
     _typ = "interval"
 
@@ -387,11 +387,6 @@ cdef class Interval(IntervalMixin):
         bool
             ``True`` if the two intervals overlap, else ``False``.
 
-        See Also
-        --------
-        IntervalArray.overlaps : The corresponding method for IntervalArray
-        IntervalIndex.overlaps : The corresponding method for IntervalIndex
-
         Examples
         --------
         >>> i1 = pd.Interval(0, 2)
@@ -414,6 +409,11 @@ cdef class Interval(IntervalMixin):
         >>> i6 = pd.Interval(1, 2, closed='neither')
         >>> i4.overlaps(i6)
         False
+
+        See Also
+        --------
+        IntervalArray.overlaps : The corresponding method for IntervalArray
+        IntervalIndex.overlaps : The corresponding method for IntervalIndex
         """
         if not isinstance(other, Interval):
             msg = '`other` must be an Interval, got {other}'

pandas/_libs/tslibs/timedeltas.pyx

@@ -1059,10 +1059,6 @@ cdef class _Timedelta(timedelta):
         -------
         formatted : str
 
-        See Also
-        --------
-        Timestamp.isoformat
-
         Notes
         -----
         The longest component is days, whose value may be larger than
@@ -1085,6 +1081,10 @@ cdef class _Timedelta(timedelta):
         'P0DT0H0M10S'
         >>> pd.Timedelta(days=500.5).isoformat()
         'P500DT12H0MS'
+
+        See Also
+        --------
+        Timestamp.isoformat
         """
         components = self.components
         seconds = '{}.{:0>3}{:0>3}{:0>3}'.format(components.seconds,
@@ -1210,14 +1210,14 @@ class Timedelta(_Timedelta):
         """
         Round the Timedelta to the specified resolution
 
-        Parameters
-        ----------
-        freq : a freq string indicating the rounding resolution
-
         Returns
         -------
         a new Timedelta rounded to the given resolution of `freq`
 
+        Parameters
+        ----------
+        freq : a freq string indicating the rounding resolution
+
         Raises
         ------
         ValueError if the freq cannot be converted

pandas/_libs/tslibs/timestamps.pyx

@@ -767,6 +767,10 @@ class Timestamp(_Timestamp):
         """
         Round the Timestamp to the specified resolution
 
+        Returns
+        -------
+        a new Timestamp rounded to the given resolution of `freq`
+
         Parameters
         ----------
         freq : a freq string indicating the rounding resolution
@@ -789,10 +793,6 @@ class Timestamp(_Timestamp):
 
             .. versionadded:: 0.24.0
 
-        Returns
-        -------
-        a new Timestamp rounded to the given resolution of `freq`
-
         Raises
         ------
         ValueError if the freq cannot be converted

pandas/core/accessor.py

@@ -201,10 +201,6 @@ def decorator(accessor):
     Name under which the accessor should be registered. A warning is issued
     if this name conflicts with a preexisting attribute.
 
-See Also
---------
-%(others)s
-
 Notes
 -----
 When accessed, your accessor will be initialized with the pandas object
@@ -254,6 +250,10 @@ def plot(self):
     (5.0, 10.0)
     >>> ds.geo.plot()
     # plots data on a map
+
+See Also
+--------
+%(others)s
 """
 
 

pandas/core/groupby/groupby.py

@@ -976,14 +976,6 @@ class GroupBy(_GroupBy):
     name : string
         Most users should ignore this
 
-    Returns
-    -------
-    **Attributes**
-    groups : dict
-        {group name -> group labels}
-    len(grouped) : int
-        Number of groups
-
     Notes
     -----
     After grouping, see aggregate, apply, and transform functions. Here are
@@ -1017,6 +1009,14 @@ class GroupBy(_GroupBy):
 
     See the online documentation for full exposition on these topics and much
     more
+
+    Returns
+    -------
+    **Attributes**
+    groups : dict
+        {group name -> group labels}
+    len(grouped) : int
+        Number of groups
     """
     def _bool_agg(self, val_test, skipna):
         """

pandas/core/resample.py

@@ -51,13 +51,13 @@ class Resampler(_GroupBy):
     kind : str or None
         'period', 'timestamp' to override default index treatement
 
-    Returns
-    -------
-    a Resampler of the appropriate type
-
     Notes
     -----
     After resampling, see aggregate, apply, and transform functions.
+
+    Returns
+    -------
+    a Resampler of the appropriate type
     """
 
     # to the groupby descriptor

pandas/core/window.py

@@ -1294,13 +1294,6 @@ def kurt(self, **kwargs):
         Returned object type is determined by the caller of the %(name)s
         calculation.
 
-    See Also
-    --------
-    pandas.Series.quantile : Computes value at the given quantile over all data
-        in Series.
-    pandas.DataFrame.quantile : Computes values at the given quantile over
-        requested axis in DataFrame.
-
     Examples
     --------
     >>> s = pd.Series([1, 2, 3, 4])
@@ -1317,6 +1310,13 @@ def kurt(self, **kwargs):
     2    2.5
     3    3.5
     dtype: float64
+
+    See Also
+    --------
+    pandas.Series.quantile : Computes value at the given quantile over all data
+        in Series.
+    pandas.DataFrame.quantile : Computes values at the given quantile over
+        requested axis in DataFrame.
     """)
 
     def quantile(self, quantile, interpolation='linear', **kwargs):