diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 7cef8c1..c33173f 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -30,9 +30,41 @@ jobs:
     - name: Build Docs
       run: |
         (cd doc && make clean && make html && make doctest)
+    - name: Fix permissions
+      run: |
+        chmod -c -R +rX "doc/" | while read line; do
+          echo "::warning title=Invalid file permissions automatically fixed::$line"
+        done
     - name: Archive Docs
       uses: actions/upload-artifact@v2
       with:
-        name: "docs"
+        name: "github-pages2"
+        path:
+          doc/html/*
+    - name: Upload Pages artifact
+      uses: actions/upload-pages-artifact@v3
+      with:
+        name: "github-pages"
         path:
-          doc/html/*
\ No newline at end of file
+          doc/html/*
+
+  deploy:
+    # Add a dependency to the build job
+    needs: build
+
+    # Grant GITHUB_TOKEN the permissions required to make a Pages deployment
+    permissions:
+      pages: write      # to deploy to Pages
+      id-token: write   # to verify the deployment originates from an appropriate source
+
+    # Deploy to the github-pages environment
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    # Specify runner + deployment step
+    runs-on: ubuntu-latest
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4