Skip to content

Standardize version bumping and the release process - #20

Merged
martnpaneq merged 15 commits into
mainfrom
cc/4642-standardize-version-bumping
Jul 31, 2026
Merged

martnpaneq merged 15 commits into
mainfrom
cc/4642-standardize-version-bumping

Conversation

@martnpaneq

@martnpaneq martnpaneq commented Jul 28, 2026 •

Copy link
Copy Markdown
Contributor

🚀 Summary

Bumping the version here meant editing four files by hand, and there was no changelog or tags. This adds a standard release process.

While working on a change: run pnpm nice and describe the change in the generated file. It gets committed with the PR.

📌 Related issues

Closes https://github.com/ckeditor/ckeditor5-internal/issues/4642.

📬 Releasing (three steps, from main):

  1. pnpm release:prepare-changelog — turns the collected entries into a CHANGELOG.md section and commits it. You pick the new version, the suggestion is based on the entry types.
  2. pnpm release:prepare-packages — writes the version to all four files and creates the release commit with a vX.Y.Z tag. Still local, so there's time to look it over.
  3. pnpm release:publish-packages — pushes main plus the tag and opens the GitHub release page.

Version bumping is scripted, so package.json, plugin.json, marketplace.json and every SKILL.md can no longer drift apart — the release also refuses to start if they already have. Nothing goes to npm; the skills are still consumed straight from the repository.

The whole thing is documented in docs/release-process.md. CHANGELOG.md starts with a 0.1.1 baseline entry for everything released so far.

📝 Followup:

  • Create the v0.1.1 tag on 72bc9e9, since the next changelog entry links back to it.

Comment thread scripts/release/publish.js Outdated
Comment thread package.json Outdated
Comment thread package.json Outdated
@martnpaneq
martnpaneq marked this pull request as draft July 29, 2026 08:25
@martnpaneq
martnpaneq marked this pull request as ready for review July 30, 2026 12:15
@martnpaneq
martnpaneq force-pushed the cc/4642-standardize-version-bumping branch from 80ba414 to 0c12da1 Compare July 30, 2026 13:40
@martnpaneq
martnpaneq force-pushed the cc/4642-standardize-version-bumping branch from 0c12da1 to 09212f3 Compare July 31, 2026 08:08
Comment thread scripts/release/preparepackages.js
Comment thread .changelog/20260731095257_cc_4642_release_process.md Outdated
Comment thread docs/release-process.md Outdated
Comment thread docs/release-process.md Outdated
Comment thread docs/release-process.md Outdated
Comment thread docs/release-process.md Outdated
Comment thread docs/release-process.md
Comment thread docs/release-process.md Outdated
Comment thread docs/release-process.md Outdated
Comment thread docs/release-process.md
Comment thread scripts/release/preparepackages.js Outdated
Comment thread scripts/release/preparepackages.js Outdated
Comment thread package.json
Comment thread pnpm-workspace.yaml
Comment thread scripts/release/utils/metadataversions.js
Comment thread scripts/release/utils/metadataversions.js
martnpaneq and others added 6 commits July 31, 2026 11:54
Co-authored-by: Kamil Piechaczek <pomek@users.noreply.github.com>
Co-authored-by: Kamil Piechaczek <pomek@users.noreply.github.com>
Co-authored-by: Kamil Piechaczek <pomek@users.noreply.github.com>
Co-authored-by: Kamil Piechaczek <pomek@users.noreply.github.com>

@pomek pomek left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM.

@martnpaneq
martnpaneq merged commit b20d580 into main Jul 31, 2026
1 check 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.

2 participants