From 74ece3ed011a17e55f2d683e46555a6e38330fb2 Mon Sep 17 00:00:00 2001
From: Max Jones <14077947+maxrjones@users.noreply.github.com>
Date: Tue, 7 Apr 2026 13:31:08 -0400
Subject: [PATCH] Pin mkdocs<2

---
 pyproject.toml | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index bcab8dd105..93ef8c5e4b 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -110,7 +110,7 @@ remote-tests = [
 docs = [
     # Doc building
     "mkdocs-material[imaging]>=9.6.14",
-    "mkdocs>=1.6.1",
+    "mkdocs>=1.6.1,<2",
     "mkdocstrings>=0.29.1",
     "mkdocstrings-python>=1.16.10",
     "mike>=2.1.3",
@@ -255,6 +255,10 @@ installer = "uv"
 features = ['remote']
 dependency-groups = ['docs']
 
+[tool.hatch.envs.docs.env-vars]
+DISABLE_MKDOCS_2_WARNING = "true"
+NO_MKDOCS_2_WARNING = "true"
+
 [tool.hatch.envs.docs.scripts]
 serve = "mkdocs serve --watch src"
 build = "mkdocs build"