On PRs (ci.yml):

  - Tests (Python 3.10-3.13) with lint, format, tests
  - Docs build check
  - CI Success gate (requires both to pass)

  On release (docs.yml):
  - Builds and deploys docs to GitHub Pages

Author: FBumann

.github/workflows/ci.yml

@@ -40,3 +40,35 @@ jobs:
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
           fail_ci_if_error: false
+
+  docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Install dependencies
+        run: uv sync --extra docs
+
+      - name: Build docs
+        run: uv run mkdocs build
+
+  ci-success:
+    name: CI Success
+    needs: [test, docs]
+    if: always()
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check all jobs passed
+        run: |
+          if [[ "${{ needs.test.result }}" != "success" ]]; then
+            echo "Test job failed or was cancelled"
+            exit 1
+          fi
+          if [[ "${{ needs.docs.result }}" != "success" ]]; then
+            echo "Docs job failed or was cancelled"
+            exit 1
+          fi
+          echo "All CI checks passed!"

.github/workflows/docs.yml

@@ -1,7 +1,7 @@
 name: Docs
 
 on:
-  push:
+  pull_request:
     branches: [main]
   release:
     types: [published]
@@ -26,6 +26,7 @@ jobs:
         run: uv run mkdocs build
 
       - name: Deploy to GitHub Pages
+        if: github.event_name == 'release'
         uses: peaceiris/actions-gh-pages@v4
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}