DOC: don't include all methods/attributes of IntervalIndex (pandas-dev#16221)

* DOC: don't include all methods/attributes of IntervalIndex

* Change docs for CategoricalIndex and IntervalIndex

No autosummary with methods for them.
Added to our hacks list in our numpydoc

* Don't exclude Interval

Author: jorisvandenbossche

doc/source/api.rst

@@ -618,7 +618,6 @@ strings and apply several methods to it. These can be accessed like
        Series.cat
        Series.dt
        Index.str
-       CategoricalIndex.str
        MultiIndex.str
        DatetimeIndex.str
        TimedeltaIndex.str
@@ -1404,6 +1403,7 @@ CategoricalIndex
 
 .. autosummary::
    :toctree: generated/
+   :template: autosummary/class_without_autosummary.rst
 
    CategoricalIndex
 
@@ -1432,6 +1432,7 @@ IntervalIndex
 
 .. autosummary::
    :toctree: generated/
+   :template: autosummary/class_without_autosummary.rst
 
    IntervalIndex
 

doc/sphinxext/numpydoc/numpydoc.py

@@ -43,7 +43,9 @@ def mangle_docstrings(app, what, name, obj, options, lines,
               )
 
     # PANDAS HACK (to remove the list of methods/attributes for Categorical)
-    if what == "class" and name.endswith(".Categorical"):
+    if what == "class" and (name.endswith(".Categorical") or
+                            name.endswith("CategoricalIndex") or
+                            name.endswith("IntervalIndex")):
         cfg['class_members_list'] = False
 
     if what == 'module':

pandas/core/indexes/category.py

@@ -47,6 +47,9 @@ class CategoricalIndex(Index, base.PandasDelegate):
     name : object
         Name to be stored in the index
 
+    See Also
+    --------
+    Categorical, Index
     """
 
     _typ = 'categoricalindex'

pandas/core/indexes/interval.py

@@ -110,6 +110,10 @@ class IntervalIndex(IntervalMixin, Index):
         Name to be stored in the index.
     copy : boolean, default False
         Copy the meta-data
+
+    See Also
+    --------
+    Index
     """
     _typ = 'intervalindex'
     _comparables = ['name']