Merge pull request #11893 from Dr-Irv/multidoc

DOC: Put MultiIndex into the main API Reference

Author: jreback

doc/source/api.rst

@@ -581,6 +581,7 @@ strings and apply several methods to it. These can be accessed like
        Series.dt
        Index.str
        CategoricalIndex.str
+       MultiIndex.str
        DatetimeIndex.str
        TimedeltaIndex.str
 
@@ -1405,6 +1406,33 @@ Categorical Components
    CategoricalIndex.as_ordered
    CategoricalIndex.as_unordered
 
+.. _api.multiindex:
+
+MultiIndex
+----------
+
+.. autosummary::
+   :toctree: generated/
+
+   MultiIndex
+
+MultiIndex Components
+~~~~~~~~~~~~~~~~~~~~~~
+
+.. autosummary::
+   :toctree: generated/
+
+   MultiIndex.from_arrays
+   MultiIndex.from_tuples
+   MultiIndex.from_product
+   MultiIndex.set_levels
+   MultiIndex.set_labels
+   MultiIndex.to_hierarchical
+   MultiIndex.is_lexsorted
+   MultiIndex.droplevel
+   MultiIndex.swaplevel
+   MultiIndex.reorder_levels
+
 .. _api.datetimeindex:
 
 DatetimeIndex

pandas/core/index.py

@@ -4030,8 +4030,7 @@ def isin(self, values, level=None):
 class MultiIndex(Index):
 
     """
-    Implements multi-level, a.k.a. hierarchical, index object for pandas
-    objects
+    A multi-level, or hierarchical, index object for pandas objects
 
     Parameters
     ----------