Generate API reference in CI instead of committing static files

- Add Python setup and package installation to docs workflow
- Add src/** to trigger paths so API changes rebuild docs
- Remove generated quartodoc reference files from tracking
- Gitignore generated reference .qmd, _sidebar.yml, and CSS

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: michaelaye

.github/workflows/docs.yml

@@ -5,6 +5,7 @@ on:
     branches: [main]
     paths:
       - 'docs/**'
+      - 'src/**'
       - '.github/workflows/docs.yml'
   workflow_dispatch:
 
@@ -26,6 +27,14 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
 
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Install package and dependencies
+        run: pip install -e ".[dev]"
+
       - name: Setup Quarto
         uses: quarto-dev/quarto-actions/setup@v2
 

.gitignore

@@ -149,6 +149,11 @@ docs/objects.json
 docs/README_files/
 docs/presentations/
 
+# Generated quartodoc API reference
+docs/reference/*.qmd
+docs/reference/_sidebar.yml
+docs/reference/_styles-quartodoc.css
+
 # Scratch/temp artifacts
 current_diffs*
 current_diffs_files/