From c2b477f19b5c30954db8825e2a225b6568e85d99 Mon Sep 17 00:00:00 2001
From: Tai Sakuma <tai.sakuma@gmail.com>
Date: Sat, 21 Mar 2026 14:26:41 -0400
Subject: [PATCH 1/2] fix: trigger docs release from changelog workflow

The v* tags are created by a workflow using GITHUB_TOKEN, which
doesn't trigger push events. Use workflow_run on "Generate changelog"
with checkout-version-tag to match the existing release pattern.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 .github/workflows/docs-release.yml | 21 ++++++++++++++-------
 1 file changed, 14 insertions(+), 7 deletions(-)

diff --git a/.github/workflows/docs-release.yml b/.github/workflows/docs-release.yml
index 37ff5f9..5b6dd9e 100644
--- a/.github/workflows/docs-release.yml
+++ b/.github/workflows/docs-release.yml
@@ -1,9 +1,9 @@
 name: Documentation (Release)
 
 on:
-  push:
-    tags:
-      - "v*"
+  workflow_run:
+    workflows: ["Generate changelog"]
+    types: [completed]
 
 permissions:
   contents: write
@@ -15,14 +15,21 @@ concurrency:
 jobs:
   deploy:
     runs-on: ubuntu-latest
+    if: github.event.workflow_run.conclusion == 'success'
     steps:
-      - uses: actions/checkout@v6
-
-      - uses: astral-sh/setup-uv@v7
+      - name: Checkout release tag
+        id: checkout
+        uses: TaiSakuma/checkout-version-tag@v1
+        with:
+          trigger-tag: ${{ github.event.workflow_run.head_branch }}
 
       - name: Extract version
         id: version
-        run: echo "version=${GITHUB_REF_NAME#v}" >> "$GITHUB_OUTPUT"
+        run: echo "version=${TAG#v}" >> "$GITHUB_OUTPUT"
+        env:
+          TAG: ${{ steps.checkout.outputs.release-tag }}
+
+      - uses: astral-sh/setup-uv@v7
 
       - name: Build docs
         run: |

From a912c2cf23ced1c6d848bd27d1c7530d25b2841e Mon Sep 17 00:00:00 2001
From: Tai Sakuma <tai.sakuma@gmail.com>
Date: Sat, 21 Mar 2026 14:32:05 -0400
Subject: [PATCH 2/2] fix: quote commit message to prevent YAML comment parsing

The `#` in `Deploy PR #<number> preview` was interpreted as a
YAML comment, truncating the commit message.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 .github/workflows/docs-pr-preview.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/docs-pr-preview.yml b/.github/workflows/docs-pr-preview.yml
index 3afb6fd..878e225 100644
--- a/.github/workflows/docs-pr-preview.yml
+++ b/.github/workflows/docs-pr-preview.yml
@@ -35,7 +35,7 @@ jobs:
       - uses: ./.github/actions/deploy-to-gh-pages
         with:
           target: pr/${{ github.event.number }}
-          commit-message: Deploy PR #${{ github.event.number }} preview
+          commit-message: "Deploy PR #${{ github.event.number }} preview"
 
       - name: Post or update PR comment
         if: steps.preview.outputs.url != ''