VWS-Python · github-actions · Aug 12, 2026 · Aug 12, 2026 · Aug 12, 2026 · Aug 12, 2026
diff --git a/docs/source/conf.py b/docs/source/conf.py
@@ -42,6 +42,11 @@
 autodoc_use_legacy_class_based = True
 
 templates_path = ["_templates"]
+
+# These fragments are pulled into ``index.rst`` with ``include`` directives
+# rather than a toctree, so keep them out of the document collection to avoid
+# ``toc.not_included`` warnings.
+exclude_patterns = ["basic-example.rst", "httpx-example.rst"]
 source_suffix = ".rst"
 master_doc = "index"
 

diff --git a/pyproject.toml b/pyproject.toml
@@ -92,7 +92,7 @@ optional-dependencies.dev = [
     "sphinx-lint==1.0.2",
     "sphinx-paramlinks==0.6",
     "sphinx-pyproject==0.3.0",
-    "sphinx-substitution-extensions==2026.6.17",
+    "sphinx-substitution-extensions==2026.8.5",
     "sphinx-toolbox==4.3.0",
     "sphinxcontrib-httpdomain==2.0.0",
     "sphinxcontrib-spelling==8.0.2",
@@ -371,6 +371,7 @@ ignore_names = [
     "DatabaseDict",
     # Too difficult to test (see notes in the code)
     "DATE_RANGE_ERROR",
+    "exclude_patterns",
     "extensions",
     # pytest fixtures - we name fixtures like this for this purpose
     "fixture_*",

diff --git a/spelling_private_dict.txt b/spelling_private_dict.txt
@@ -113,6 +113,7 @@ str
 stringify
 subprocess
 timestamp
+toctree
 todo
 travis
 txt

diff --git a/uv.lock b/uv.lock
-Original file line number
+Diff line change
@@ Expand Up / @@ -113,6 +113,7 @@ str @@
     stringify
     subprocess
     timestamp
+    toctree
     todo
     travis
     txt
@@ Expand Down @@