DOC: Improved the docstring of pandas.Series.set_axis

Author: astrastefania

pandas/core/generic.py

@@ -487,24 +487,30 @@ def _expand_axes(self, key):
 
         return new_axes
 
-    _shared_docs['set_axis'] = """Assign desired index to given axis
+    _shared_docs['set_axis'] = """
+        Assign desired index to given axis.
+
+        Indexes for columns or rows can be changed by assigning a list-like or Index.
 
         Parameters
         ----------
-        labels: list-like or Index
-            The values for the new index
-        axis : int or string, default 0
+        labels : list-like, Index
+            The values for the new index.
+
+        axis : int, default 0
+            The value 0 indentify the rows, 1 identify the columns.
+
         inplace : boolean, default None
             Whether to return a new %(klass)s instance.
 
             WARNING: inplace=None currently falls back to to True, but
             in a future version, will default to False.  Use inplace=True
             explicitly rather than relying on the default.
 
-        .. versionadded:: 0.21.0
-            The signature is make consistent to the rest of the API.
-            Previously, the "axis" and "labels" arguments were respectively
-            the first and second positional arguments.
+            .. versionadded:: 0.21.0
+                The signature is make consistent to the rest of the API.
+                Previously, the "axis" and "labels" arguments were respectively
+                the first and second positional arguments.
 
         Returns
         -------
@@ -513,7 +519,7 @@ def _expand_axes(self, key):
 
         See Also
         --------
-        pandas.NDFrame.rename
+        pandas.DataFrame.rename_axis : Alter the name of the index or columns.
 
         Examples
         --------
@@ -545,7 +551,6 @@ def _expand_axes(self, key):
         0  1   4
         1  2   5
         2  3   6
-
         """
 
     @Appender(_shared_docs['set_axis'] % dict(klass='NDFrame'))