Publish Athena Client docs only when a release is created. (#21)

* ci: only trigger doc build on release publish

* ci: build on push but don't publish

Author: snus-kin

.github/workflows/docs.yml

@@ -19,6 +19,8 @@ on:
       - "README.md"
       - "pyproject.toml"
       - ".github/workflows/docs.yml"
+  release:
+    types: [published]
   workflow_dispatch:
     inputs:
       reason:
@@ -58,19 +60,25 @@ jobs:
       - name: Build documentation
         run: |
           cd docs
-          uv run make clean
-          uv run make html
+          uv run make clean html
 
       - name: Setup Pages
         uses: actions/configure-pages@v5
-        if: github.ref == 'refs/heads/main' || github.ref == 'refs/heads/master'
+        if: github.event_name == 'release' && github.event.action == 'published'
 
-      - name: Upload artifact
+      - name: Upload artifact for GitHub Pages
         uses: actions/upload-pages-artifact@v4
-        if: github.ref == 'refs/heads/main' || github.ref == 'refs/heads/master'
+        if: github.event_name == 'release' && github.event.action == 'published'
         with:
           path: docs/_build/html
 
+      - name: Upload documentation artifacts
+        uses: actions/upload-artifact@v4
+        if: github.event_name != 'release'
+        with:
+          name: documentation
+          path: docs/_build/html
+
       - name: Upload build artifacts for debugging
         uses: actions/upload-artifact@v4
         if: failure()
@@ -86,7 +94,7 @@ jobs:
       url: ${{ steps.deployment.outputs.page_url }}
     runs-on: ubuntu-latest
     needs: build
-    if: github.ref == 'refs/heads/main' || github.ref == 'refs/heads/master'
+    if: github.event_name == 'release' && github.event.action == 'published'
     steps:
       - name: Deploy to GitHub Pages
         id: deployment