Checkpoint to see if this is working.

Author: billnapier

.github/workflows/publish_docs.yml

@@ -12,6 +12,7 @@ permissions:
 
 jobs:
   build:
+    name: "Build Docs"
     runs-on: 'ubuntu-latest'
     steps:
     - uses: 'actions/checkout@v4'
@@ -25,6 +26,7 @@ jobs:
       with:
         path: 'generated-pages'
   deploy:
+    name: "Deploy Docs"
     environment:
       name: 'github-pages'
       url: '${{ steps.deployment.outputs.page_url }}'

.github/workflows/publish_docs_preview.yml

@@ -9,13 +9,12 @@ on:
       - closed
 
 permissions:
-  pages: 'write'
-  id-token: 'write'
   contents: 'write'
   pull-requests: 'write'
 
 jobs:
   build:
+    name: "Build PR Preview Docs"
     runs-on: 'ubuntu-latest'
     steps:
     - uses: 'actions/checkout@v4'

.github/workflows/publish_docs_preview_branch.yml

@@ -0,0 +1,31 @@
+name: 'Publish Preview of Docs Site from branch'
+
+# The publish_docs_preview.yml workflow takes a PR and publishes the results to it's own branch 
+# so users can preview it.  But that git branch then needs some way to publish, so this action does that.
+
+on: 
+  push:
+    branch:
+        - gh-pages
+
+permissions:
+  pages: 'write'
+  id-token: 'write'
+
+jobs:
+  stage:
+    name: "Stage PR preview from branch to pages"
+    runs-on: 'ubuntu-latest'
+    steps:
+    - uses: 'actions/checkout@v4'
+  deploy:
+    name: "Deploy PR Preview from branch to pages"
+    needs: 'stage'
+    environment:
+      name: 'gh-pages-pr-preview'
+      url: '${{ steps.deployment.outputs.page_url }}'
+    runs-on: 'ubuntu-latest'
+    steps:
+      - name: 'Deploy to GitHub Pages'
+        id: 'deployment'
+        uses: 'actions/deploy-pages@v4'