Add edutap.esc_router_api to the package documentation

.gitmodules

@@ -5,3 +5,6 @@
 [submodule "submodules/edutap.wallet_apple"]
 	path = submodules/edutap.wallet_apple
 	url = https://github.com/edutap-eu/edutap.wallet_apple.git
+[submodule "submodules/edutap.esc_router_api"]
+	path = submodules/edutap.esc_router_api
+	url = https://github.com/edutap-eu/edutap.esc_router_api.git

requirements.txt

@@ -5,7 +5,9 @@ sphinx-issues
 sphinx-copybutton
 sphinxcontrib-mermaid
 sphinx-autobuild
+sphinx-design
 sphinxcontrib.spelling
 autodoc_pydantic
 -e submodules/edutap.wallet_google
 -e submodules/edutap.wallet_apple
+-e submodules/edutap.esc_router_api

source/conf.py

@@ -42,6 +42,8 @@
     "sphinx.ext.autodoc",
     "sphinx.ext.autosummary",
     "sphinxcontrib.autodoc_pydantic",
+    # The esc_router_api landing page uses grids and cards.
+    "sphinx_design",
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -50,7 +52,16 @@
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
 # This pattern also affects html_static_path and html_extra_path.
-exclude_patterns = []
+exclude_patterns = [
+    # The package documentation is symlinked in from each submodule's own `docs/`
+    # directory, so whatever else lives there arrives with it: the package's own
+    # Sphinx configuration, its build output, its documentation virtualenv, and its
+    # working documents. None of that belongs in this build.
+    "packages/*/conf.py",
+    "packages/*/_build/**",
+    "packages/*/.venv/**",
+    "packages/*/superpowers/**",
+]
 
 
 # -- Options for HTML output -------------------------------------------------

source/packages/edutap_esc_router_api

@@ -0,0 +1 @@
+../../submodules/edutap.esc_router_api/docs/

source/packages/index.md

@@ -11,5 +11,6 @@ caption: Contents
 getting_started.md
 edutap_wallet_google/index.md
 edutap_wallet_apple/index.md
+edutap_esc_router_api/index.md
 
 ```