docker + datenhaltung refreshed

docs/Makefile

@@ -0,0 +1,14 @@
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR      = .
+BUILDDIR       = _build
+
+.PHONY: help html clean
+
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)"
+
+html:
+	@$(SPHINXBUILD) -M html "$(SOURCEDIR)" "$(BUILDDIR)"
+
+clean:
+	rm -rf $(BUILDDIR)

docs/conf.py

@@ -1,5 +1,8 @@
-# Sphinx-Konfiguration – wird nach jedem Meilenstein mit flask seed-db und
-# sphinx-apidoc -o docs/source/ app/ aktualisiert.
+import os
+import sys
+
+# Projektroot ins sys.path, damit 'import app' funktioniert
+sys.path.insert(0, os.path.abspath(".."))
 
 project = "OIDC Flask Showcase"
 author = "Bjoern Runden"
@@ -12,3 +15,10 @@ extensions = [
 
 exclude_patterns = ["_build"]
 html_theme = "alabaster"
+
+# Autodoc-Optionen: Docstrings auch aus __init__ holen
+autodoc_default_options = {
+    "members": True,
+    "undoc-members": True,
+    "show-inheritance": True,
+}

docs/index.rst

@@ -5,17 +5,4 @@ OIDC Flask Showcase – Dokumentation
    :maxdepth: 2
    :caption: Module:
 
-.. automodule:: app
-   :members:
-
-.. automodule:: app.config
-   :members:
-
-.. automodule:: app.models
-   :members:
-
-.. automodule:: app.auth
-   :members:
-
-.. automodule:: app.routes
-   :members:
+   source/modules

docs/source/app.rst

@@ -0,0 +1,53 @@
+app package
+===========
+
+Submodules
+----------
+
+app.auth module
+---------------
+
+.. automodule:: app.auth
+   :members:
+   :show-inheritance:
+   :undoc-members:
+
+app.config module
+-----------------
+
+.. automodule:: app.config
+   :members:
+   :show-inheritance:
+   :undoc-members:
+
+app.database module
+-------------------
+
+.. automodule:: app.database
+   :members:
+   :show-inheritance:
+   :undoc-members:
+
+app.models module
+-----------------
+
+.. automodule:: app.models
+   :members:
+   :show-inheritance:
+   :undoc-members:
+
+app.routes module
+-----------------
+
+.. automodule:: app.routes
+   :members:
+   :show-inheritance:
+   :undoc-members:
+
+Module contents
+---------------
+
+.. automodule:: app
+   :members:
+   :show-inheritance:
+   :undoc-members:

docs/source/modules.rst

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