From 3dbce1d61f900bb094aa89d4630b42b7619e4d1e Mon Sep 17 00:00:00 2001
From: Pete R Jemian <prjemian@users.noreply.github.com>
Date: Mon, 26 Feb 2024 10:14:46 -0600
Subject: [PATCH] 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 => docs.yml} | 16 +++++++++++++---
 1 file changed, 13 insertions(+), 3 deletions(-)
 rename .github/workflows/{pages.yml => docs.yml} (77%)

diff --git a/.github/workflows/pages.yml b/.github/workflows/docs.yml
similarity index 77%
rename from .github/workflows/pages.yml
rename to .github/workflows/docs.yml
index ba8a4bca..ba7e2940 100644
--- a/.github/workflows/pages.yml
+++ b/.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: