Close to an "alpha"

.github/workflows/docs.yml

@@ -3,7 +3,11 @@
 
 name: Documentation
 
-on: [push, pull_request]
+on:
+  pull_request:
+  push:
+    branches:
+      - main
 
 permissions:
   contents: read
@@ -17,7 +21,7 @@ jobs:
         doxygen-version: [1.9.6, 1.14.0]
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           persist-credentials: false
 
@@ -32,21 +36,17 @@ jobs:
       - name: Build
         run: |
           cd doc
-          doxygen
-
-          SPHINXOPTS="-W" make html
-
+          make html
           mkdir deploy
-          mv _build_doxygen/html deploy/doxygen
           mv _build_sphinx/html/* deploy
 
       - name: Setup pages
         if: github.event_name != 'pull_request' && matrix.doxygen-version == '1.14.0'
-        uses: actions/configure-pages@v4
+        uses: actions/configure-pages@v5
 
       - name: Upload pages artifact
         if: github.event_name != 'pull_request' && matrix.doxygen-version == '1.14.0'
-        uses: actions/upload-pages-artifact@v3
+        uses: actions/upload-pages-artifact@v4
         with:
           path: doc/deploy
 
@@ -65,6 +65,10 @@ jobs:
     permissions:
       pages: write
       id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
     steps:
       - name: Deploy to GitHub Pages
-        uses: actions/deploy-pages@v4
+        id: deployment
+        uses: actions/deploy-pages@v5

.gitignore

@@ -14,3 +14,4 @@ __pycache__/
 
 # docs
 /doc/_build*
+/app/build/