docs: pin mkdocs<2 and silence the mkdocs-material advisory banner in CI (#3072)

2026-07-07 13:45:30 +01:00 · 2026-07-07 13:45:30 +01:00 · 6d2e908f2b
commit 6d2e908f2b
parent 867bba6263
1 changed files with 16 additions and 5 deletions
--- a/pyproject.toml
+++ b/pyproject.toml
@ -76,7 +76,9 @@ dev = [
    "opentelemetry-sdk>=1.39.1",
 ]
 docs = [
-    "mkdocs>=1.6.1",
+    # MkDocs 2.0 is a ground-up rewrite (no plugin system) that is incompatible
+    # with mkdocs-material and every plugin below; stay on the 1.x line.
+    "mkdocs>=1.6.1,<2",
    "mkdocs-gen-files>=0.5.0",
    "mkdocs-glightbox>=0.4.0",
    "mkdocs-literate-nav>=0.6.1",