The Release Process

The Release Process

Fully automated release workflow with one-click publishing.

Quick Steps

1. Check master build: Verify green build at build-test-package.yml

2. Trigger release: Run Release & Start Next workflow:

   • Enter next_version (e.g., 7.2.4, 7.3.0)
   • Check prerelease if RC/beta, otherwise leave unchecked
   • Leave draft: true to review before publishing

3. Review & publish: Go to Releases, review draft, click "Publish release"

4. Auto-triggered: When published, the Release: Changelog, Milestones & Marketing workflow runs:

   • Generates changelog entry in changelog/<tag>.md
   • Updates CHANGELOG.md
   • Generates social media posts
   • Closes release milestone (stable releases only)
   • Moves pending issues/PRs to next version (stable releases only)

5. Merge version bump: Merge the auto-opened "Start release" PR

What Workflows Do

Workflow	When	What
release-publish.yml	Manual dispatch	Creates GitHub Release from latest build
release-prepare.yml	Auto (by publish)	Bumps version, opens PR
sync-changelog.yml	Auto (on publish)	Changelog + milestones (skip for pre-releases)

---

Updated: 2026-05-02 — Fully automated workflow (was manual process)