From cf47e65756072151398c77a04004883bfbac65b7 Mon Sep 17 00:00:00 2001
From: Thomas Duignan <thomas.j.duignan@gmail.com>
Date: Tue, 13 Oct 2026 14:39:06 -0400
Subject: [PATCH] ci: dispatch documentation after successful releases

---
 .github/workflows/main.yaml | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/main.yaml b/.github/workflows/main.yaml
index 9ef3df7b..24cd1792 100644
--- a/.github/workflows/main.yaml
+++ b/.github/workflows/main.yaml
@@ -1,5 +1,6 @@
 name: Package
 permissions:
+  actions: write
   contents: write
   id-token: write
 on:
@@ -38,7 +39,7 @@ jobs:
         run: UV_PROJECT_ENVIRONMENT="$CONDA_PREFIX" uv sync --inexact
       - name: Get version bump
         id: get-tag
-        run: echo "bump=$(python version.py)" >> $GITHUB_OUTPUT
+        run: echo "bump=$(python version.py)" >> "$GITHUB_OUTPUT"
       - name: Run tests
         if: steps.get-tag.outputs.bump != ''
         env:
@@ -55,6 +56,14 @@ jobs:
       - name: Save git tag
         if: steps.get-tag.outputs.bump != ''
         run: git push origin ${{ steps.get-tag.outputs.bump }}
+      # Tag pushes made with GITHUB_TOKEN do not trigger other workflows.
+      - name: Trigger documentation deployment
+        if: steps.get-tag.outputs.bump != ''
+        env:
+          GH_TOKEN: ${{ github.token }}
+          GH_REPO: ${{ github.repository }}
+          RELEASE_TAG: ${{ steps.get-tag.outputs.bump }}
+        run: gh workflow run docs.yaml --ref "$RELEASE_TAG"
       - name: Post coverage comment
         if: steps.get-tag.outputs.bump != ''
         uses: py-cov-action/python-coverage-comment-action@v3