Merge pull request #173 from ryantm/rm-3-4-doc

doc: try a slightly different format for github action

.github/workflows/doc.yml

@@ -1,34 +1,43 @@
-name: doc
+# Simple workflow for deploying static content to GitHub Pages
+name: Deploy static content to Pages
 
 on:
+  # Runs on pushes targeting the default branch
   push:
-    branches:
+    branches: [$default-branch]
-      - main
+
+  # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:
 
-jobs:
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
-  publish:
+permissions:
-    permissions:
   contents: read
   pages: write
   id-token: write
-    concurrency:
+
+# Allow one concurrent deployment
+concurrency:
   group: "pages"
   cancel-in-progress: true
+
+jobs:
+  # Single deploy job since we're just deploying
+  deploy:
     environment:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - name: Checkout
-      - uses: cachix/install-nix-action@v20
+        uses: actions/checkout@v3
-      - run: nix build .#doc
       - name: Setup Pages
         uses: actions/configure-pages@v3
+      - uses: cachix/install-nix-action@v20
+      - run: nix build .#doc
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v1
         with:
-          path: 'result/multi'
+          path: './result/multi'
       - name: Deploy to GitHub Pages
         id: deployment
         uses: actions/deploy-pages@v1