Skip to content

fix: include synced plugin changelogs in the release commit - #43

Merged
steve-calvert-glean merged 1 commit into
mainfrom
fix/release-changelog-staging
Oct 28, 2026
Merged

steve-calvert-glean merged 1 commit into
mainfrom
fix/release-changelog-staging

Conversation

@steve-calvert-glean

Copy link
Copy Markdown
Contributor

The plugins ship stale changelogs. After npm run release, shared/glean/CHANGELOG.md and shared/glean-dev-docs/CHANGELOG.md are left modified and uncommitted, and the 3.6.0 plugins ship changelogs that stop at 3.5.0.

Cause

release-it stages the release files during its beforeRelease phase, right after the changelog plugin writes CHANGELOG.md. Our build hook ran later, in before:git:release. The build copies the root changelog into each shared plugin, so those copies changed after staging and missed the commit. publish.yml ships the committed files, so the stale copies shipped.

#22 moved the hook from after:bump, which runs before the changelog is written, to before:git:release, which runs after staging. Both miss.

Fix

  • Run the build in before:git:beforeRelease. It runs after the changelog is written and before staging.
  • Commit the current synced changelogs.
  • Fail CI when the committed plugin changelogs differ from the build output. This would have flagged the last two release commits.
  • Update RELEASE.md to match.

Testing

I ran release-it with --ci --no-git.push --no-git.tag --no-github.release in two throwaway clones:

Clone Plugin changelogs in the release commit Dirty files afterward
This branch Both None
main Neither Both plugin changelogs

release-it stages the release files during the beforeRelease phase. The build hook ran later, in before:git:release, so the changelogs it copied into shared/glean and shared/glean-dev-docs were left out of the commit, and the plugins shipped stale changelogs. Run the build in before:git:beforeRelease instead, after the changelog is written and before staging.

Also commit the current synced changelogs, and fail CI when the committed copies differ from the build output.
@steve-calvert-glean
steve-calvert-glean marked this pull request as ready for review October 28, 2026 16:54
@steve-calvert-glean
steve-calvert-glean requested a review from a team as a code owner October 28, 2026 16:54
@steve-calvert-glean steve-calvert-glean added bug Something isn't working internal labels Oct 28, 2026
@steve-calvert-glean
steve-calvert-glean merged commit e25db42 into main Oct 28, 2026
1 check passed
@steve-calvert-glean
steve-calvert-glean deleted the fix/release-changelog-staging branch October 28, 2026 16:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working internal

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant