add docs workflow

.github/workflows/docs.yml

@@ -0,0 +1,26 @@
+name: docs
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main
+  pull_request:
+
+jobs:
+  docs:
+    name: Build documentation and check links
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - name: Build documentation
+        run: |
+          python3 -m pip install --upgrade pip
+          python3 -m pip install -r docs/requirements.txt
+          cd docs
+          make html