Skip to content

fix: explicitly dispatch docs deployment from create-tag.yml - #99

Merged
97gamjak merged 1 commit into
devfrom
bugfix/docs-trigger-recursion-token
Sep 13, 2026
Merged

97gamjak merged 1 commit into
devfrom
bugfix/docs-trigger-recursion-token

Conversation

@97gamjak

Copy link
Copy Markdown
Owner

Summary

  • Root cause of "docs stopped deploying entirely": create-tag.yml pushes the release tag using the default GITHUB_TOKEN. GitHub explicitly blocks events triggered by GITHUB_TOKEN from starting other workflow runs (anti-recursion protection), so docs.yml's on.push.tags trigger never actually fired for any release tag (confirmed via gh run list — no run exists for the 0.1.3 tag push at all).
  • Fix: create-tag.yml now explicitly dispatches the Docs workflow via gh workflow run docs.yml --ref "$version" right after pushing the tag (needs actions: write permission, added).
  • docs.yml's deploy condition now also accepts workflow_dispatch regardless of ref (not just tag pushes), so a missed/broken release's docs can be redeployed manually without cutting a new version.

Test plan

  • Confirmed via gh run list --workflow=docs.yml that no run was ever triggered by a tag push (root cause)
  • YAML-validated both modified workflow files with yaml.safe_load
  • Next release cut through create-tag.yml should show a Docs run triggered by workflow_dispatch pinned to the new tag, followed by a successful deploy

🤖 Generated with Claude Code

https://claude.ai/code/session_0126spNDGtqDKMoYtuPT7JfW

GitHub blocks events triggered by GITHUB_TOKEN from starting other
workflows (anti-recursion protection), so the release tag pushed by
create-tag.yml never actually triggered docs.yml's tag-push trigger -
docs stopped deploying entirely after the previous fix. Dispatch the
Docs workflow explicitly via `gh workflow run docs.yml --ref <tag>`
instead, and allow workflow_dispatch to deploy regardless of ref so a
missed release can be redeployed manually.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0126spNDGtqDKMoYtuPT7JfW
@97gamjak
97gamjak merged commit 6c11aa2 into dev Sep 13, 2026
3 checks passed
@97gamjak
97gamjak deleted the bugfix/docs-trigger-recursion-token branch September 13, 2026 13:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant