From a0a1d37b9efb4b475ca41c5ef1ea6a0244ccbb8a Mon Sep 17 00:00:00 2001
From: Jim Garrison <garrison@ibm.com>
Date: Fri, 6 Sep 2024 14:51:04 -0400
Subject: [PATCH] Prepare second docs artifact, for human consumption

---
 .github/workflows/docs.yml | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 29955f7..ca3584f 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -40,12 +40,26 @@ jobs:
         shell: bash
         run: |
           tox -edocs
-      - name: Upload docs artifact
-        if: always()
+      - name: Upload docs artifact for GitHub Pages
         uses: actions/upload-pages-artifact@v3
         with:
           path: docs/_build/html
 
+      # Provide a nicely named artifact that extracts into an
+      # identically named subdirectory.
+      - name: Prepare nice docs artifact for humans
+        if: always()
+        shell: bash
+        run: |
+          mkdir artifact
+          cp -a docs/_build/html artifact/qiskit-addon-utils-htmldocs
+      - name: Upload nice docs artifact
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: qiskit-addon-utils-htmldocs
+          path: ./artifact
+
   deploy:
     name: Deploy docs
     if: ${{ github.ref == 'refs/heads/stable/0.1' }}