DOC: Improve the docstring of Index.get_level_values

Author: bkil-syslogng

pandas/core/indexes/base.py

@@ -2788,26 +2788,45 @@ def set_value(self, arr, key, value):
 
     def _get_level_values(self, level):
         """
+        Return an Index of values for requested level, specially useful for
+        MultiIndex.
+
         Return an Index of values for requested level, equal to the length
-        of the index.
+        of the index. This is mainly useful for MultiIndex.
 
         Parameters
         ----------
         level : int or str
-            ``level`` is either the integer position of the level in the
-            MultiIndex, or the name of the level.
+            It is either the integer position or the name of the level.
+            If given as an integer, it must be between 0 and the
+            number of levels - 1.
 
         Returns
         -------
         values : Index
-            ``self``, as there is only one level in the Index.
+            `self`, as there is only one level in the Index.
 
         See also
         ---------
         pandas.MultiIndex.get_level_values : get values for a level of a
                                              MultiIndex
-        """
 
+        Notes
+        ---------
+        For Index, level should be 0, since there are no multiple levels.
+
+        Examples
+        ---------
+
+        >>> idx = pd.Index(list('abc'))
+        >>> idx
+        Index(['a', 'b', 'c'], dtype='object')
+
+        Get level value by supplying level as integer:
+
+        >>> idx.get_level_values(0)
+        Index(['a', 'b', 'c'], dtype='object')
+        """
         self._validate_index_level(level)
         return self