Revert "Remove commented out sections"

This reverts commit 534fc3a.

Author: vyasr

doc/source/reference/arrays.rst

@@ -603,6 +603,18 @@ 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,6 +25,47 @@ 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,3 +53,22 @@ 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