Fix docs CI: disable mkdocstrings in CI (no baft importable)

API reference pages need baft importable, which requires loom as a
sibling dir. Use MKDOCSTRINGS_ENABLED env var to skip autodoc in CI
while keeping all non-API pages building correctly.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: Hooman Mehr

.github/workflows/docs.yml

@@ -35,6 +35,10 @@ jobs:
 
       - name: Build docs
         run: .docs-venv/bin/mkdocs build
+        env:
+          MKDOCSTRINGS_ENABLED: "false"
+          # API reference pages require baft importable (needs ../loom).
+          # Disable mkdocstrings in CI; API docs render locally.
 
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3

mkdocs.yml

@@ -38,6 +38,9 @@ theme:
 plugins:
   - search
   - mkdocstrings:
+      enabled: !ENV [MKDOCSTRINGS_ENABLED, true]
+      default_handler: python
+      enable_inventory: false
       handlers:
         python:
           options: