From 2250e5b45d18fd180d010e9d2771a4ac8fbd2db3 Mon Sep 17 00:00:00 2001 From: laughingman7743 Date: Fri, 2 Jan 2026 00:59:31 +0900 Subject: [PATCH 1/3] Fix docs deployment from tag triggers MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Always checkout master branch in the docs workflow, even when triggered by a tag push. This ensures GitHub Pages accepts the deployment since it's configured with source.branch: master. sphinx-multiversion still builds all versions (tags + master) because fetch-depth: 0 fetches all refs. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 --- .github/workflows/docs.yaml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/.github/workflows/docs.yaml b/.github/workflows/docs.yaml index 7690dc14..173aa936 100644 --- a/.github/workflows/docs.yaml +++ b/.github/workflows/docs.yaml @@ -24,7 +24,8 @@ jobs: - name: Checkout uses: actions/checkout@v4 with: - fetch-depth: 0 # Fetch all history for version detection + ref: master # Always checkout master for GitHub Pages deployment + fetch-depth: 0 # Fetch all history for sphinx-multiversion - name: Setup Pages uses: actions/configure-pages@v5 - uses: astral-sh/setup-uv@v5 From 0a1c1cfc98426e641d811ca8a1758c3564b03008 Mon Sep 17 00:00:00 2001 From: laughingman7743 Date: Fri, 2 Jan 2026 01:14:38 +0900 Subject: [PATCH 2/3] Fix docs deployment for tag pushes using workflow_dispatch MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit GitHub Pages only accepts deployments from the master branch context. When a tag push triggered the docs workflow, the deployment would silently fail to update the live site. This change: - Removes the tag trigger from docs.yaml - Adds docs-trigger.yaml that triggers the docs workflow via workflow_dispatch API when a tag is pushed - This ensures the docs workflow always runs in master context while still being triggered by tag releases 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 --- .github/workflows/docs-trigger.yaml | 22 ++++++++++++++++++++++ .github/workflows/docs.yaml | 1 - 2 files changed, 22 insertions(+), 1 deletion(-) create mode 100644 .github/workflows/docs-trigger.yaml diff --git a/.github/workflows/docs-trigger.yaml b/.github/workflows/docs-trigger.yaml new file mode 100644 index 00000000..db3523f1 --- /dev/null +++ b/.github/workflows/docs-trigger.yaml @@ -0,0 +1,22 @@ +name: Trigger Docs on Tag + +on: + push: + tags: ['v*'] + +permissions: + actions: write + +jobs: + trigger-docs: + runs-on: ubuntu-latest + steps: + - uses: actions/github-script@v7 + with: + script: | + await github.rest.actions.createWorkflowDispatch({ + owner: context.repo.owner, + repo: context.repo.repo, + workflow_id: 'docs.yaml', + ref: 'master' + }) diff --git a/.github/workflows/docs.yaml b/.github/workflows/docs.yaml index 173aa936..f17f8fa8 100644 --- a/.github/workflows/docs.yaml +++ b/.github/workflows/docs.yaml @@ -4,7 +4,6 @@ on: workflow_dispatch: push: branches: ['master'] - tags: ['v*'] permissions: contents: read From 856fb17b4fb238e3ba68c2e115014a072ab61f5d Mon Sep 17 00:00:00 2001 From: laughingman7743 Date: Fri, 2 Jan 2026 01:19:07 +0900 Subject: [PATCH 3/3] Remove unnecessary ref: master from checkout step MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The workflow now only runs from master context (push to master or workflow_dispatch with ref: master), so explicit ref is redundant. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 --- .github/workflows/docs.yaml | 1 - 1 file changed, 1 deletion(-) diff --git a/.github/workflows/docs.yaml b/.github/workflows/docs.yaml index f17f8fa8..4f534bbe 100644 --- a/.github/workflows/docs.yaml +++ b/.github/workflows/docs.yaml @@ -23,7 +23,6 @@ jobs: - name: Checkout uses: actions/checkout@v4 with: - ref: master # Always checkout master for GitHub Pages deployment fetch-depth: 0 # Fetch all history for sphinx-multiversion - name: Setup Pages uses: actions/configure-pages@v5