Deploy docs to github pages

Author: benjeffery

.github/workflows/docs.yml

@@ -3,7 +3,7 @@ name: Build Docs
 on:
   pull_request:
   push:
-    branches: [main]
+    branches: [main, test]
     tags:
       - '*'
 
@@ -32,3 +32,25 @@ jobs:
       - name: Build Docs
         run: |
           make -C docs
+
+      - name: Upload Pages Artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/_build/html
+
+  deploy:
+    needs: build
+
+    permissions:
+        pages: write
+        id-token: write
+
+    environment:
+        name: github-pages
+        url: ${{ steps.deployment.outputs.page_url }}
+
+    runs-on: ubuntu-latest
+    steps:
+        - name: Deploy to GitHub Pages
+          id: deployment
+          uses: actions/deploy-pages@v4