Trigger docs build from release workflow

Add workflow_dispatch input to docs workflow for specifying a git ref.
Release workflow now triggers docs build after creating GitHub release,
passing the version tag to build versioned documentation.

Author: coreyleavitt

.github/workflows/docs.yml

@@ -10,6 +10,11 @@ on:
   push:
     tags: ['v*']
   workflow_dispatch:
+    inputs:
+      ref:
+        description: 'Git ref to build docs from (tag or branch)'
+        required: false
+        type: string
 
 permissions:
   contents: read
@@ -31,17 +36,20 @@ jobs:
     steps:
       - uses: actions/checkout@v4
         with:
-          # For workflow_run, checkout the commit that triggered CI
-          ref: ${{ github.event.workflow_run.head_sha || github.ref }}
+          # Priority: workflow_dispatch input > workflow_run commit > current ref
+          ref: ${{ inputs.ref || github.event.workflow_run.head_sha || github.ref }}
 
       - name: Install uv
         uses: astral-sh/setup-uv@v4
 
       - name: Determine version
         id: version
         run: |
-          if [[ "$GITHUB_REF" == refs/tags/v* ]]; then
-            VERSION="${GITHUB_REF#refs/tags/v}"
+          # Check input ref first (from workflow_dispatch), then GITHUB_REF
+          REF="${{ inputs.ref || github.ref }}"
+          if [[ "$REF" == refs/tags/v* ]] || [[ "$REF" == v* ]]; then
+            VERSION="${REF#refs/tags/}"
+            VERSION="${VERSION#v}"
           else
             VERSION="latest"
           fi
@@ -71,8 +79,10 @@ jobs:
       - name: Determine version
         id: version
         run: |
-          if [[ "$GITHUB_REF" == refs/tags/v* ]]; then
-            VERSION="${GITHUB_REF#refs/tags/v}"
+          REF="${{ inputs.ref || github.ref }}"
+          if [[ "$REF" == refs/tags/v* ]] || [[ "$REF" == v* ]]; then
+            VERSION="${REF#refs/tags/}"
+            VERSION="${VERSION#v}"
           else
             VERSION="latest"
           fi

.github/workflows/release.yml

@@ -34,6 +34,7 @@ on:
 
 permissions:
   contents: write
+  actions: write  # Required to trigger docs workflow
 
 jobs:
   prepare-version:
@@ -202,3 +203,10 @@ jobs:
           fi
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Trigger docs build
+        run: |
+          VERSION="${{ needs.prepare-version.outputs.version }}"
+          gh workflow run docs.yml -f ref="v$VERSION"
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}