Skip to content

RELEASE.md

Latest commit

 

History

History
21 lines (17 loc) · 1.22 KB

RELEASE.md

File metadata and controls

21 lines (17 loc) · 1.22 KB
Raw

Release process

  1. Update CHANGELOG.md: move entries from [Unreleased] to a new [X.Y.Z] - YYYY-MM-DD section. (This project does not store version in composer.json; Packagist uses the git tag.)
  2. Update UPGRADING.md if the release has upgrade notes.
  3. Run pre-release checks: make release-check (includes check-no-cursor-coauthor, cs-fix, cs-check, rector-dry, phpstan, test-coverage, and optionally demo healthchecks).
  4. Commit all changes, create an annotated tag (e.g. v1.2.10), and push branch and tag. The release workflow will create the GitHub Release with the changelog.
  5. Publish the package to Packagist if applicable (usually automatic when the tag is pushed).

After creating the release commit and tag, run make check-no-cursor-coauthor again before git push (REQ-GIT-001). The release commit itself is not covered by an earlier release-check run.

Example for v2.0.5

git add -A
git status   # review
git commit -m "Release 2.0.5: FrankenPHP worker hardening, final DI types, demo smoke"
git tag -a v2.0.5 -m "Release 2.0.5: FrankenPHP worker hardening, final DI types, demo smoke"
make check-no-cursor-coauthor
git push origin main
git push origin v2.0.5