docs: update sphinx conf and index toc

Author: jankapunkt

docs/conf.py

@@ -94,7 +94,7 @@
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-html_theme = 'default'
+html_theme = 'sphinx_rtd_theme'
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
@@ -246,7 +246,11 @@
 
 
 # Example configuration for intersphinx: refer to the Python standard library.
-intersphinx_mapping = {'http://docs.python.org/': None}
+intersphinx_mapping = {
+    "rtd": ("https://docs.readthedocs.io/en/stable/", None),
+    "python": ("https://docs.python.org/3/", None),
+    "sphinx": ("https://www.sphinx-doc.org/en/master/", None),
+}
 
 todo_include_todos = True
 

docs/index.rst

@@ -45,16 +45,15 @@ Example Usage
 
 See the :doc:`/model/spec` of what is required from the model passed to :doc:`/api/oauth2-server`.
 
+Contents
+--------
 
 .. toctree::
-   :hidden:
-
    Home <self>
 
 .. toctree::
    :maxdepth: 2
    :caption: User Documentation
-   :hidden:
 
    docs/getting-started
    docs/adapters
@@ -63,7 +62,6 @@ See the :doc:`/model/spec` of what is required from the model passed to :doc:`/a
    :maxdepth: 2
    :caption: API
    :includehidden:
-   :hidden:
 
    api/oauth2-server
    api/request
@@ -73,15 +71,13 @@ See the :doc:`/model/spec` of what is required from the model passed to :doc:`/a
 .. toctree::
    :maxdepth: 3
    :caption: Model
-   :hidden:
 
    model/overview
    model/spec
 
 .. toctree::
    :maxdepth: 2
    :caption: Miscellaneous
-   :hidden:
 
    misc/extension-grants
    misc/pkce