remove pandas API from the documentation (#1330)

* ignore the api generated files

* use generated file in the API page

* build the API everywhere it's needed

* drop pandas api documentation

* remove pandas related warnings

* add autosummary parameters

* build documentation in rdt

* check warning in the static nox build

* use autoapi instead of apidoc

* fix: drop pandas page

* fix: remove api page

.gitignore

@@ -60,6 +60,7 @@ instance/
 # Sphinx documentation
 docs/_build/
 docs/examples/generated/
+docs/api/
 warnings.txt
 
 # PyBuilder

docs/conf.py

@@ -25,13 +25,15 @@
 # -- General configuration ---------------------------------------------------
 
 extensions = [
+    "sphinx.ext.napoleon",
     "sphinx.ext.autodoc",
     "sphinx.ext.autosummary",
     "sphinx.ext.todo",
     "sphinx.ext.viewcode",
     "sphinxext.rediraffe",
     "sphinx_design",
     "sphinx_copybutton",
+    "autoapi.extension",
     "_extension.gallery_directive",
     # For extension examples and demos
     "ablog",
@@ -64,11 +66,6 @@
     sitemap_locales = [None]
     sitemap_url_scheme = "{link}"
 
-
-# -- autosummary -------------------------------------------------------------
-
-autosummary_generate = True
-
 # -- Internationalization ----------------------------------------------------
 
 # specifying the natural language populates some key tags
@@ -243,6 +240,18 @@
     {"name": "msapplication-TileImage", "content": "mstile-150x150.png"},
 ]
 
+# -- Options for autosummary/autodoc output ------------------------------------
+autosummary_generate = True
+autodoc_typehints = "description"
+autodoc_member_order = "groupwise"
+
+# -- Options for autoapi -------------------------------------------------------
+autoapi_type = "python"
+autoapi_dirs = ["../src/pydata_sphinx_theme"]
+autoapi_keep_files = True
+autoapi_root = "api"
+autoapi_member_order = "groupwise"
+
 # -- application setup -------------------------------------------------------