WIP docs config

docs/_templates/layout.html

@@ -0,0 +1,6 @@
+{% extends "!layout.html" %}
+
+{% block document %}
+HELLO WORLD
+
+{% endblock %}

docs/conf.py

@@ -7,7 +7,7 @@
 extensions = [
     "sphinx.ext.autodoc",
     "sphinx.ext.napoleon",
-    "sphinx_autodoc_typehints",  # Must come *after* sphinx.ext.napoleon.
+    # "sphinx_autodoc_typehints",  # Must come *after* sphinx.ext.napoleon.
     "sphinx.ext.autosummary",
     "sphinx.ext.coverage",
     "sphinx.ext.doctest",
@@ -39,8 +39,9 @@
 # on_rtd is whether we are on readthedocs.org
 on_rtd = os.environ.get("READTHEDOCS", None) == "True"
 
-if not on_rtd:  # only set the theme if we"re building docs locally
-    html_theme = "sphinx_rtd_theme"
+
+html_theme = "sphinx_rtd_theme"
+html_static_path = ["_static"]
 
 html_use_smartypants = True
 html_last_updated_fmt = "%b %d, %Y"

docs/reference/interdoc.rst

@@ -1,9 +1,30 @@
-interdoc
-========
+interdoc package
+================
 
-.. testsetup::
+Submodules
+----------
 
-    from interdoc import *
+interdoc.app module
+-------------------
+
+.. automodule:: interdoc.app
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+interdoc.cli module
+-------------------
+
+.. automodule:: interdoc.cli
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+
+Module contents
+---------------
 
 .. automodule:: interdoc
-    :members:
+   :members:
+   :undoc-members:
+   :show-inheritance:

docs/reference/modules.rst

@@ -0,0 +1,7 @@
+src
+===
+
+.. toctree::
+   :maxdepth: 4
+
+   interdoc

docs/theme.conf

@@ -0,0 +1,4 @@
+[theme]
+inherit = default
+stylesheet = style.css
+pygments_style = pygments.css

docs/theme/theme.conf

@@ -0,0 +1,4 @@
+[theme]
+inherit = default
+stylesheet = style.css
+pygments_style = pygments.css