From 90dd493f3d8d86ad89e3706507edaa594937eb05 Mon Sep 17 00:00:00 2001
From: Abdessamad Derraz <3028866+Abdess@users.noreply.github.com>
Date: Thu, 22 Oct 2026 13:53:34 +0200
Subject: [PATCH] chore: declare the mkdocs pin with the theme

---
 pyproject.toml          | 3 +++
 wiki/release-process.md | 3 ++-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index ac501527..2036926e 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -23,6 +23,9 @@ dev = [
 # declared nowhere, so a contributor following either had to read the
 # workflow to learn what to install.
 docs = [
+    # MkDocs 2 drops plugins, and the theme, in maintenance since 9.7.0,
+    # will not follow it.
+    "mkdocs>=1.6,<2",
     "mkdocs-material>=9.7.5,<10",
     "pymdown-extensions>=10.14",
 ]
diff --git a/wiki/release-process.md b/wiki/release-process.md
index cfe47134..5e280881 100644
--- a/wiki/release-process.md
+++ b/wiki/release-process.md
@@ -45,7 +45,8 @@ is missing.
 
 1. Checkout, Python 3.12
 2. Install `pyyaml`, `jsonschema[format-nongpl]==4.26.0`,
-   `mkdocs-material>=9.7.5,<10`, `pymdown-extensions>=10.14`
+   `mkdocs>=1.6,<2`, `mkdocs-material>=9.7.5,<10`,
+   `pymdown-extensions>=10.14`
 3. Run `validate_schemas.py`: the data contracts, checked before anything is
    generated (see below)
 4. Restore large files from the `large-files` release, refresh data directories