Skip to content

feat(workflows): notify homepage repo on stable superdoc release#3216

Merged
caio-pizzol merged 2 commits into
mainfrom
caio-pizzol/notify-homepage-on-stable-release
May 10, 2026
Merged

feat(workflows): notify homepage repo on stable superdoc release#3216
caio-pizzol merged 2 commits into
mainfrom
caio-pizzol/notify-homepage-on-stable-release

Conversation

@caio-pizzol
Copy link
Copy Markdown
Contributor

Fires a repository_dispatch to superdoc-dev/homepage whenever a stable SuperDoc release lands, so the homepage's superdoc dependency can be auto-bumped via a single PR.

  • Mirrors promote-stable-docs.yml: workflow_run on 📦 Release superdoc, gated on success + head_branch == 'stable', with a comm -23 tag-diff against the triggering head_sha to filter out semantic-release no-ops.
  • Sends package, version, tag, plus the upstream release run id and this notify run id, so the receiver workflow can link back.
  • Kept out of release-superdoc.yml deliberately — that job sits in the release-stable concurrency group, and a homepage/token failure must not mark a successful npm publish as failed.

Receiver workflow lives in superdoc-dev/homepage (separate PR). Requires the existing GitHub App to be installed on superdoc-dev/homepage with contents: write (for the dispatch endpoint and branch push) and pull-requests: write (for the PR open/update).

Mirrors the promote-stable-docs.yml pattern: workflow_run on Release
superdoc, gated on success + stable, with a tag-diff against the
triggering head_sha to filter out semantic-release no-ops. Sends
repository_dispatch to superdoc-dev/homepage so a receiver workflow
there can open one bump PR per release.

Kept out of release-superdoc.yml on purpose: that job sits in the
release-stable concurrency group, and a homepage/token failure should
not mark a successful npm publish as failed.
@caio-pizzol caio-pizzol requested a review from a team as a code owner May 10, 2026 11:43
@caio-pizzol caio-pizzol merged commit 94614cd into main May 10, 2026
11 checks passed
@caio-pizzol caio-pizzol deleted the caio-pizzol/notify-homepage-on-stable-release branch May 10, 2026 12:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant