docs: checklists: Rework release checklist
The changelog regularly gets entries in the wrong places. Document a
process that might help avoid the problem in the future.
Change-Id: I85f30ded23557e77c54d22c3bd8f1eb7e5bf1307
Signed-off-by: Andrew Jeffery <andrew@codeconstruct.com.au>
diff --git a/docs/checklists/releases.md b/docs/checklists/releases.md
index cffcb55..d1e5d93 100644
--- a/docs/checklists/releases.md
+++ b/docs/checklists/releases.md
@@ -1,14 +1,29 @@
# Checklist for making releases of `libpldm`
+## Meson
+
- [ ] Update the version in `meson.build`
-- [ ] Add the tag value header in `CHANGELOG.md`
+
+## ABI
- [ ] Generate the ABI dump for the release
- This must be done from a shell session inside the OpenBMC CI Docker
container for consistency
+## Evolutions
+
- [ ] Rename the directory for unreleased evolutions
+
+## CHANGELOG
+
+- [ ] Replace the `Unreleased` header with the tag value and the date
+- [ ] Remove headers of empty sections from current release
+- [ ] Introduce new `Unreleased` header
+- [ ] Add the usual list of headers with empty sections
+
+## Tagging
+
- [ ] Commit the changes above with the subject `libpldm: Release <version>`
- [ ] Push the release commit for review in Gerrit
- [ ] Submit the release commit once approved