Skip to content

docs(repository-dispatch): use real token name in README example#143

Merged
Piotr1215 merged 1 commit into
mainfrom
fix/dispatch-readme-token
May 11, 2026
Merged

docs(repository-dispatch): use real token name in README example#143
Piotr1215 merged 1 commit into
mainfrom
fix/dispatch-readme-token

Conversation

@Piotr1215
Copy link
Copy Markdown
Contributor

Summary

The Usage example in .github/actions/repository-dispatch/README.md referenced secrets.CROSS_REPO_DISPATCH_TOKEN, which isn't a secret that exists in any caller repo. Anyone copying the example would wire up a non-existent secret and silently end up with an empty GH_TOKEN, causing repository_dispatch to fail authentication on the target repo.

The canonical caller in this repo (.github/workflows/dispatch-integration-tests.yaml:31) and loft-sh/loft-enterprise's release.yaml both use VCLUSTERLABS_DISPATCH_TOKEN. This PR aligns the README example with the real secret name so copy-paste works.

The typo was introduced in #140 (the original PR that added this composite action).

Scope

  • Single line change to the Usage example
  • Auto-generated input table (between AUTO-DOC-INPUT:START/END) untouched — out of scope

Follow-up after merge

The repository-dispatch/v1 floating tag needs to be force-moved to the merge commit so existing consumers pinned at @repository-dispatch/v1 pick up the fix (same retag pattern used for DEVOPS-855 / v1.3.1). Flagging here so a human with retag permissions can do it.

Test plan

  • grep -n CROSS_REPO_DISPATCH_TOKEN .github/actions/repository-dispatch/README.md returns nothing
  • Cross-checked with .github/workflows/dispatch-integration-tests.yaml (this repo) and loft-sh/loft-enterprise release.yaml — both use VCLUSTERLABS_DISPATCH_TOKEN

The Usage example referenced `secrets.CROSS_REPO_DISPATCH_TOKEN`, which
is not a secret that exists in any caller repo. Anyone copying the
example would wire up a non-existent secret and silently get an empty
GH_TOKEN — repository_dispatch would then fail authentication on the
target repo. The canonical caller in this repo
(`.github/workflows/dispatch-integration-tests.yaml`) and loft-enterprise's
release.yaml both use `VCLUSTERLABS_DISPATCH_TOKEN`. Align the example
with reality so the copy-paste path works.
@Piotr1215 Piotr1215 merged commit 9208a14 into main May 11, 2026
5 checks passed
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