Skip to content

fix(changelog): Fix broken workflow that never successfully created a PR - #18874

Open
sfanahata wants to merge 1 commit into
masterfrom
fix/changelog-workflow-bugs
Open

fix(changelog): Fix broken workflow that never successfully created a PR#18874
sfanahata wants to merge 1 commit into
masterfrom
fix/changelog-workflow-bugs

Conversation

@sfanahata

Copy link
Copy Markdown
Contributor

Problem

The Update Docs Changelog workflow has been failing on every single run since it was introduced (April 3, 2026 -- 118 consecutive failures). The changelog page has been stuck showing March 2026 content.

Root Cause

Two bugs in the "Create PR with changes" step of .github/workflows/update-docs-changelog.yml:

  1. --label 'Type: Maintenance' references a label that doesn't exist in this repo. gh pr create exits with code 1 when given a nonexistent label, killing the step immediately.

  2. gh pr merge was called without a PR reference, so it couldn't determine which PR to merge (even if bug JavaScript docs don't reference the right version #1 were fixed).

Fix

  • Remove the --label 'Type: Maintenance' flag
  • Pass "$branch" to gh pr merge so it knows which PR to merge
  • Add set -euxo pipefail for better diagnostics on any future failures

Cleanup

Deleted all 118 orphaned bot/update-docs-changelog-* branches that accumulated from the daily failing runs.

Verification

  • Ran node scripts/update-docs-changelog.mjs locally -- script generates 20 changelog entries successfully
  • Verified gh pr merge accepts a branch name argument (gh pr merge [<number> | <url> | <branch>])
  • Confirmed "Type: Maintenance" label does not exist in the repo's 156 labels

Next Steps

After merging, trigger the workflow manually via the Actions tab (workflow_dispatch) to verify the full end-to-end flow works in CI.

Two bugs prevented the changelog automation from ever working (all 118
runs since April 2026 have failed):

1. --label 'Type: Maintenance' referenced a label that doesn't exist
   in the repo, causing gh pr create to exit with code 1.

2. gh pr merge was called without a PR reference, so it couldn't
   determine which PR to merge.

Also adds set -euxo pipefail for better diagnostics on future failures,
and deletes 118 orphaned bot/update-docs-changelog-* branches.
@vercel

vercel Bot commented Jul 29, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
develop-docs Ready Ready Preview Jul 29, 2026 7:56pm
sentry-docs Ready Ready Preview Jul 29, 2026 7:56pm

Request Review

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