Skip to content

docs: correct the GITHUB_TOKEN release flow - #16

Merged
lloydsk merged 1 commit into
mainfrom
docs/github-token-flow
Sep 21, 2026
Merged

lloydsk merged 1 commit into
mainfrom
docs/github-token-flow

Conversation

@lloydsk

@lloydsk lloydsk commented Sep 21, 2026

Copy link
Copy Markdown
Collaborator

Both the docs and the workflow comments claimed a GITHUB_TOKEN Release PR "can never report lint-test and can never be merged", and that a token was therefore required. That is wrong.

GitHub exempts pull_request events with the opened, synchronize, and reopened activity types: runs for a GITHUB_TOKEN-created PR start in an approval-required state rather than being suppressed, so approving them satisfies lint-test without bypassing anything.

The real remaining constraint is different: release is not an exempt event, so a release-please-created Release does not fire release: published. Publishing is therefore a manual dispatch.

Documents the actual flow — no secret, one approve click, one publish command — and keeps the token path as the way to remove both manual steps. Verified: dispatching release-please with no secret now returns success, where the same dispatch was a 403 while the unauthorised PAT was still set.

@github-actions

Copy link
Copy Markdown

CI report

Check Result
tsc --noEmit success
tests success
npm pack --dry-run success (7 files in tarball)

Ref: 83b8edcb4c6b773aac9f7c4daeb5b57e3be88757

@lloydsk
lloydsk merged commit 7d10856 into main Sep 21, 2026
2 checks passed
@lloydsk
lloydsk deleted the docs/github-token-flow branch September 21, 2026 14:44
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