DOC: update the Index.get_values docstring

pandas/core/indexes/base.py

@@ -681,7 +681,53 @@ def _values(self):
         return self.values
 
     def get_values(self):
-        """ return the underlying data as an ndarray """
+        """
+        Return `Index` data as an `numpy.ndarray`.
+
+        In its functionality it is the same as `Series.get_values`,
+        but because it refers only to `Index` values, it does not need
+        the additional sparse transformation work.
+
+        It is a getter wrapper around `Index.values`. Getters are
+        often considered non-pythonic and, therefore, should be avoided if are
+        not explicitly aimed for.
+
+        Returns
+        -------
+        numpy.ndarray
+            A one-dimensional `numpy array` of the indexes.
+
+        See Also
+        --------
+        Index.values : The original function around which `get_values` wraps.
+
+        Examples
+        --------
+        Getting the `Index` values of a `DataFrame`:
+
+        >>> df = pd.DataFrame([[1, 2, 3], [4, 5, 6], [7, 8, 9]],
+        ...                    index=['a', 'b', 'c'], columns=['A', 'B', 'C'])
+        >>> df
+           A  B  C
+        a  1  2  3
+        b  4  5  6
+        c  7  8  9
+        >>> df.index.get_values()
+        array(['a', 'b', 'c'], dtype=object)
+
+        Standalone `Index` values:
+
+        >>> idx = pd.Index(['1', '2', '3'])
+        >>> idx.get_values()
+        array(['1', '2', '3'], dtype=object)
+
+        `MultiIndex` arrays also have only one dimension:
+
+        >>> midx = pd.MultiIndex.from_arrays([[1, 2, 3], ['a', 'b', 'c']],
+        ...                                  names =  ('number', 'letter'))
+        >>> midx.ndim
+        1
+        """
         return self.values
 
     @Appender(IndexOpsMixin.memory_usage.__doc__)