Restore locked documentation requirements for reproducible builds

Add back docs/requirements.txt with locked versions to ensure reproducible
documentation builds on ReadTheDocs.

Changes:
- Add docs-lock task to regenerate requirements.txt from uv.lock
- Generate docs/requirements.txt with locked dependency versions
- Update .readthedocs.yml to install from requirements.txt
- Update .pre-commit-config.yaml uv-export hook to only export docs group
- Update CONTRIBUTING.md to document docs-lock task and pre-commit hook

The pre-commit hook automatically updates docs/requirements.txt when
dependencies change, ensuring it stays in sync with pyproject.toml.

Author: claude

.pre-commit-config.yaml

@@ -28,4 +28,4 @@ repos:
     rev: 0.9.18  # uv version
     hooks:
       - id: uv-export
-        args: [ "--frozen", "--no-hashes", "--no-annotate", "--output-file=docs/requirements.txt" ]
+        args: [ "--frozen", "--no-hashes", "--no-annotate", "--only-group=docs", "--no-dev", "--output-file=docs/requirements.txt" ]

.readthedocs.yml

@@ -11,8 +11,6 @@ build:
   tools:
     python: "3.10"
   jobs:
-    post_install:
-      - pip install zensical mkdocstrings-python
     post_build:
       - zensical build
       - mkdir -p $READTHEDOCS_OUTPUT/html/
@@ -21,5 +19,6 @@ build:
 # Install the package
 python:
   install:
+    - requirements: docs/requirements.txt
     - method: pip
       path: .

CONTRIBUTING.md

@@ -109,10 +109,15 @@ uv run task docs-clean
 
 # Serve documentation with auto-reload
 uv run task docs-serve
+
+# Update documentation requirements
+uv run task docs-lock
 ```
 
 After building, the documentation will be available in `docs/_build/zensical/`.
 
+The `uv-export` pre-commit hook automatically updates `docs/requirements.txt` when dependencies change.
+
 ## Project Structure
 
 ```

docs/requirements.txt

@@ -0,0 +1,52 @@
+# This file was autogenerated by uv via the following command:
+#    uv export --frozen --no-hashes --no-annotate --only-group docs --no-dev --output-file docs/requirements.txt
+astunparse==1.6.3 ; python_full_version < '3.9'
+click==8.1.8 ; python_full_version < '3.10'
+click==8.3.1 ; python_full_version >= '3.10'
+colorama==0.4.6
+deepmerge==2.0 ; python_full_version >= '3.10'
+ghp-import==2.1.0
+griffe==1.4.0 ; python_full_version < '3.9'
+griffe==1.14.0 ; python_full_version == '3.9.*'
+griffe==1.15.0 ; python_full_version >= '3.10'
+importlib-metadata==8.5.0 ; python_full_version < '3.9'
+importlib-metadata==8.7.0 ; python_full_version == '3.9.*'
+jinja2==3.1.6
+markdown==3.7 ; python_full_version < '3.9'
+markdown==3.9 ; python_full_version == '3.9.*'
+markdown==3.10 ; python_full_version >= '3.10'
+markupsafe==2.1.5 ; python_full_version < '3.9'
+markupsafe==3.0.3 ; python_full_version >= '3.9'
+mergedeep==1.3.4
+mkdocs==1.6.1
+mkdocs-autorefs==1.2.0 ; python_full_version < '3.9'
+mkdocs-autorefs==1.4.3 ; python_full_version >= '3.9'
+mkdocs-get-deps==0.2.0
+mkdocstrings==0.26.1 ; python_full_version < '3.9'
+mkdocstrings==0.30.1 ; python_full_version == '3.9.*'
+mkdocstrings==1.0.0 ; python_full_version >= '3.10'
+mkdocstrings-python==1.11.1 ; python_full_version < '3.9'
+mkdocstrings-python==1.18.2 ; python_full_version == '3.9.*'
+mkdocstrings-python==2.0.1 ; python_full_version >= '3.10'
+packaging==25.0
+pathspec==0.12.1
+platformdirs==4.3.6 ; python_full_version < '3.9'
+platformdirs==4.4.0 ; python_full_version == '3.9.*'
+platformdirs==4.5.1 ; python_full_version >= '3.10'
+pygments==2.19.2 ; python_full_version >= '3.10'
+pymdown-extensions==10.15 ; python_full_version < '3.9'
+pymdown-extensions==10.19.1 ; python_full_version >= '3.9'
+python-dateutil==2.9.0.post0
+pyyaml==6.0.3
+pyyaml-env-tag==0.1 ; python_full_version < '3.9'
+pyyaml-env-tag==1.1 ; python_full_version >= '3.9'
+six==1.17.0
+tomli==2.3.0 ; python_full_version == '3.10.*'
+typing-extensions==4.13.2 ; python_full_version < '3.9'
+typing-extensions==4.15.0 ; python_full_version >= '3.9' and python_full_version < '3.11'
+watchdog==4.0.2 ; python_full_version < '3.9'
+watchdog==6.0.0 ; python_full_version >= '3.9'
+wheel==0.45.1 ; python_full_version < '3.9'
+zensical==0.0.21 ; python_full_version >= '3.10'
+zipp==3.20.2 ; python_full_version < '3.9'
+zipp==3.23.0 ; python_full_version == '3.9.*'

pyproject.toml

@@ -96,6 +96,7 @@ relative-imports-order = "closest-to-furthest"
 docs = "zensical build"
 docs-clean = "rm -rf docs/_build/"
 docs-serve = "zensical serve"
+docs-lock = "uv export --frozen --no-hashes --no-annotate --only-group docs --no-dev --output-file docs/requirements.txt"
 test = "pytest"
 test-cov = "pytest --cov=src"
 test-cov-report = "pytest --cov=src --cov-report=html"