2026-09-05 21:03:04 +00:00
1 changed files with 14 additions and 1 deletions
@@ -59,8 +59,21 @@ alternative was — the diff already says what changed. If a fix was subtle,
 say what made it subtle; if a test caught something, say what. Commits here
 are the only design record this project has.
 ### Release pull requests
 Because `main` is squash-merged, a pull request title becomes a commit message
-on `main`. Give it the same treatment.
+on `main`. A release spans a fix, a feature and some chores at once, so none
 of the types above fits it honestly. Use `release:` instead:
 ```
 release: repair the catalog 404 and stop the page jumping
 ```
 `main`'s log is then one line per deployment, which is what that branch is
 for, and the pull request body serves as the release notes. No version in the
 title — the CalVer tag is not created until `make image` runs after the merge.
 The types above are for `dev`, where a commit really does do one thing.
 ## Things that are easy to get wrong