From b0d85bc406523308840f89b3f406eb06976b4ad1 Mon Sep 17 00:00:00 2001
From: Hayden <64056131+hay-kot@users.noreply.github.com>
Date: Sat, 20 Dec 2025 20:31:33 -0600
Subject: [PATCH] ci(docs): isolate docs dependencies to avoid python-ldap
 build

Add dedicated docs dependency group with only mkdocs-material to avoid
installing python-ldap during docs builds. python-ldap requires OpenLDAP
dev headers (libldap2-dev) which aren't available on standard CI runners.
---
 .github/workflows/docs.yml | 2 +-
 pyproject.toml             | 3 +++
 uv.lock                    | 4 ++++
 3 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 747c4127f..f2d15c3da 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -27,7 +27,7 @@ jobs:
         uses: astral-sh/setup-uv@v4
 
       - name: Install dependencies
-        run: uv sync --group dev
+        run: uv sync --only-group docs
 
       - name: Build docs
         run: uv run mkdocs build -d site
diff --git a/pyproject.toml b/pyproject.toml
index 8fede788e..e838f790d 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -57,6 +57,9 @@ pgsql = [
 ]
 
 [dependency-groups]
+docs = [
+    "mkdocs-material==9.7.0",
+]
 dev = [
     "coverage==7.13.0",
     "coveragepy-lcov==0.1.2",
diff --git a/uv.lock b/uv.lock
index 9b4f1dbbb..0741e5f4f 100644
--- a/uv.lock
+++ b/uv.lock
@@ -880,6 +880,9 @@ dev = [
     { name = "types-requests" },
     { name = "types-urllib3" },
 ]
+docs = [
+    { name = "mkdocs-material" },
+]
 
 [package.metadata]
 requires-dist = [
@@ -946,6 +949,7 @@ dev = [
     { name = "types-requests", specifier = "==2.32.4.20250913" },
     { name = "types-urllib3", specifier = "==1.26.25.14" },
 ]
+docs = [{ name = "mkdocs-material", specifier = "==9.7.0" }]
 
 [[package]]
 name = "mergedeep"