Remove commented out sections

doc/source/reference/arrays.rst

@@ -603,18 +603,6 @@ with a bool :class:`numpy.ndarray`.
    NA
 
 
-.. Dtype attributes which are manually listed in their docstrings: including
-.. it here to make sure a docstring page is built for them
-
-..
-    .. autosummary::
-      :toctree: api/
-
-      DatetimeTZDtype.unit
-      DatetimeTZDtype.tz
-      PeriodDtype.freq
-      IntervalDtype.subtype
-
 *********
 Utilities
 *********

doc/source/reference/extensions.rst

@@ -25,47 +25,6 @@ objects.
    api.extensions.ExtensionArray
    arrays.NumpyExtensionArray
 
-.. We need this autosummary so that methods and attributes are generated.
-.. Separate block, since they aren't classes.
-
-   .. autosummary::
-      :toctree: api/
-
-      api.extensions.ExtensionArray._accumulate
-      api.extensions.ExtensionArray._concat_same_type
-      api.extensions.ExtensionArray._formatter
-      api.extensions.ExtensionArray._from_factorized
-      api.extensions.ExtensionArray._from_sequence
-      api.extensions.ExtensionArray._from_sequence_of_strings
-      api.extensions.ExtensionArray._hash_pandas_object
-      api.extensions.ExtensionArray._reduce
-      api.extensions.ExtensionArray._values_for_argsort
-      api.extensions.ExtensionArray._values_for_factorize
-      api.extensions.ExtensionArray.argsort
-      api.extensions.ExtensionArray.astype
-      api.extensions.ExtensionArray.copy
-      api.extensions.ExtensionArray.view
-      api.extensions.ExtensionArray.dropna
-      api.extensions.ExtensionArray.equals
-      api.extensions.ExtensionArray.factorize
-      api.extensions.ExtensionArray.fillna
-      api.extensions.ExtensionArray.insert
-      api.extensions.ExtensionArray.interpolate
-      api.extensions.ExtensionArray.isin
-      api.extensions.ExtensionArray.isna
-      api.extensions.ExtensionArray.pad_or_backfill
-      api.extensions.ExtensionArray.ravel
-      api.extensions.ExtensionArray.repeat
-      api.extensions.ExtensionArray.searchsorted
-      api.extensions.ExtensionArray.shift
-      api.extensions.ExtensionArray.take
-      api.extensions.ExtensionArray.unique
-      api.extensions.ExtensionArray.dtype
-      api.extensions.ExtensionArray.nbytes
-      api.extensions.ExtensionArray.ndim
-      api.extensions.ExtensionArray.shape
-      api.extensions.ExtensionArray.tolist
-
 Additionally, we have some utility methods for ensuring your object
 behaves correctly.
 

doc/source/reference/index.rst

@@ -53,22 +53,3 @@ are mentioned in the documentation.
    options
    extensions
    testing
-
-.. This is to prevent warnings in the doc build. We don't want to encourage
-.. these methods.
-
-..
-    .. toctree::
-
-        api/pandas.Index.holds_integer
-        api/pandas.Index.nlevels
-        api/pandas.Index.sort
-
-
-.. Can't convince sphinx to generate toctree for this class attribute.
-.. So we do it manually to avoid a warning
-
-..
-    .. toctree::
-
-        api/pandas.api.extensions.ExtensionDtype.na_value