upload built documentation as artifact from github actions workflow (#…

…275)

* MNT #274 rename consistent with other projects

* CI #274 add upload to workflow and re-arrange per murky project

* WIP #274 Diagnostic

* WIP #274 find the built docs

* CI #274 re-enable upload & deploy steps

* CI #274 put a name on the file

.github/workflows/pages.yml → .github/workflows/docs.yml

@@ -27,8 +27,8 @@ defaults:
 jobs:
 
   pages:
-
-    runs-on: ubuntu-20.04
+    name: Publish documentation
+    runs-on: ubuntu-latest
 
     steps:
 
@@ -45,13 +45,23 @@ jobs:
     - name: Set time zone
       run: echo "TZ=America/Chicago" >> "$GITHUB_ENV"
 
-    - id: deployment
+    - name: Sphinx build
+      id: deployment
       uses: sphinx-notes/pages@v3
       with:
         documentation_path: ./docs/source
         publish: false
         requirements_path: ./docs/requirements.txt
 
+    - name: Diagnostic
+      run: ls -lAFgh ${{ steps.deployment.outputs.artifact }}
+
+    - name: Upload Docs ZIP file as artifact
+      uses: actions/upload-artifact@v4
+      with:
+        name: bluesky_training-docs
+        path: ${{ steps.deployment.outputs.artifact }}
+
     - uses: peaceiris/actions-gh-pages@v3
       if: ${{ github.event.inputs.deploy }}
       with: