DOC: Fix introduced docstring validation errors (pandas-dev#25356)

Author: ihsansecer

pandas/core/arrays/categorical.py

@@ -773,16 +773,16 @@ def as_unordered(self, inplace=False):
         """
         Set the Categorical to be unordered.
 
-        Returns
-        -------
-        Categorical
-            Unordered Categorical.
-
         Parameters
         ----------
         inplace : bool, default False
            Whether or not to set the ordered attribute in-place or return
            a copy of this categorical with ordered set to False.
+
+        Returns
+        -------
+        Categorical
+            Unordered Categorical.
         """
         inplace = validate_bool_kwarg(inplace, 'inplace')
         return self.set_ordered(False, inplace=inplace)

pandas/core/generic.py

@@ -9322,7 +9322,7 @@ def tz_convert(self, tz, axis=0, level=None, copy=True):
         Returns
         -------
         %(klass)s
-            %(klass)s with time zone converted axis.
+            Object with time zone converted axis.
 
         Raises
         ------

pandas/core/groupby/groupby.py

@@ -1301,7 +1301,7 @@ def groupby_function(name, alias, npfunc,
             Returns
             -------
             Series or DataFrame
-                %(f)s of values within each group.
+                Computed %(f)s of values within each group.
             """
 
             @Substitution(name='groupby', f=name)

pandas/core/indexes/base.py

@@ -4819,16 +4819,16 @@ def get_slice_bound(self, label, side, kind):
         Returns leftmost (one-past-the-rightmost if ``side=='right'``) position
         of given label.
 
-        Returns
-        -------
-        int
-            Indice of label.
-
         Parameters
         ----------
         label : object
         side : {'left', 'right'}
         kind : {'ix', 'loc', 'getitem'}
+
+        Returns
+        -------
+        int
+            Indice of label.
         """
         assert kind in ['ix', 'loc', 'getitem', None]