Release Notes
When To Use
Product ships changes and support hears about them from customers. Use this at every release, when you need to answer: what changed that a customer would notice, who is affected, and what does support need to know before the first ticket arrives?
When Not To Use
If the release needs sales training, a launch tier and team readiness, Release Notes is too small; run the Go-to-Market Plan and write the notes from it. If nothing changed that a customer would notice, skip the customer version and keep the internal one.
Inputs
- The list of changes: tickets, merged work, PR titles or a PRD, with the version and release date
- Anything removed, deprecated or changed in behaviour, and who uses it today (segments or plans, not named customers)
- Known issues and workarounds from engineering or QA
If you have none of this, I start from a plain list of what shipped and mark the output as a first draft with every "who is affected" line "[to check]".
Approach
I use Keep a Changelog by Olivier Lacan (keepachangelog.com/en/1.1.0/): notes are for humans, not machines, latest version first with a date, and every change sits under one type: Added, Changed, Deprecated, Removed, Fixed, Security. An Unreleased section holds what is coming. The judgment is translation: a ticket title says what engineering did, a note says what the customer can now do. The failure it prevents: a pasted commit log ("refactor auth middleware") that tells a customer nothing and support even less.
Workflow
- Ask up to three questions: the version number and release date, who reads the customer version (in-app, email, docs), and who approves before publishing.
- Drop internal-only work (refactors, tooling, tests) from the customer version. Merge tickets that make one visible change into one line.
- Sort each remaining change under Added, Changed, Deprecated, Removed, Fixed or Security. Behaviour changes to existing features go under Changed, never hidden under Fixed.
- Rewrite each line in plain words from the customer's side: what they can now do, or what now works. One line, no ticket numbers in the customer version.
- Write the internal version for support: every line plus known issues, workarounds, who is affected (segment, plan or setting) and where to escalate.
- For Security items, keep detail minimal and check with a qualified adviser before publishing specifics. Move anything not yet shipped to Unreleased.
Output Format
# Release Notes
## [Version] [YYYY-MM-DD]
### Added
- [what customers can now do]
### Changed
- [behaviour that works differently now]
### Deprecated / Removed / Fixed / Security
- [line, plain words]
## Internal version for support
| Change | Who is affected | Known issue | Workaround | Escalate to |
|---|---|---|---|---|
| [change] | [segment / plan / setting] | [issue or none] | [workaround] | [role] |
## Unreleased
- [coming change, no date promised]
## Decision
[Named person] approves the customer notes before they are published on [date]; support receives the internal version by [date].
Done When
- Every customer line sits under one of the six change types
- No ticket numbers, commit messages or internal jargon in the customer version
- Removed and deprecated items say what to use instead
- Support has the internal version before customers see the notes
Quality Bar
- Never name a customer in the notes without their permission
- Changed behaviour is labelled Changed, even when it is embarrassing
- No invented dates, versions or fixes; unknowns stay in brackets
- Security wording is checked with a qualified adviser before publishing details
- A named person approves before notes are published.
Next
Run pm-success-metrics (Success Metrics) to check whether the change worked.
About the makers
This pack is made by 90n (90n.ai): AI-native ways of working and tools for Product, Marketing and HR teams, built by ex-McKinsey founders. We map where time and money leak, redesign the work around AI and stay until your people run it themselves, and we run our own company on Claude. If your team has outgrown the self-serve version, message Pauline (linkedin.com/in/paulinebertry).
1---2name: pm-release-notes3description: Writes Release Notes for customers grouped by change type, an internal version for support with known issues and workarounds, and a who-is-affected list. Use for "run pm-release-notes", "release notes", "write the changelog", "what's new post", "turn these tickets into release notes", "support heard about it from customers", "notes for this release", part of the AI for Product Management Pack by 90n.4metadata:5 source: https://skillmd.com/skills/polar-bear-org/pm-release-notes6---78# Release Notes910## When To Use11Product ships changes and support hears about them from customers. Use this at every release, when you need to answer: what changed that a customer would notice, who is affected, and what does support need to know before the first ticket arrives?1213## When Not To Use14If the release needs sales training, a launch tier and team readiness, Release Notes is too small; run the Go-to-Market Plan and write the notes from it. If nothing changed that a customer would notice, skip the customer version and keep the internal one.1516## Inputs17- The list of changes: tickets, merged work, PR titles or a PRD, with the version and release date18- Anything removed, deprecated or changed in behaviour, and who uses it today (segments or plans, not named customers)19- Known issues and workarounds from engineering or QA20If you have none of this, I start from a plain list of what shipped and mark the output as a first draft with every "who is affected" line "[to check]".2122## Approach23I use Keep a Changelog by Olivier Lacan (keepachangelog.com/en/1.1.0/): notes are for humans, not machines, latest version first with a date, and every change sits under one type: Added, Changed, Deprecated, Removed, Fixed, Security. An Unreleased section holds what is coming. The judgment is translation: a ticket title says what engineering did, a note says what the customer can now do. The failure it prevents: a pasted commit log ("refactor auth middleware") that tells a customer nothing and support even less.2425## Workflow261. Ask up to three questions: the version number and release date, who reads the customer version (in-app, email, docs), and who approves before publishing.272. Drop internal-only work (refactors, tooling, tests) from the customer version. Merge tickets that make one visible change into one line.283. Sort each remaining change under Added, Changed, Deprecated, Removed, Fixed or Security. Behaviour changes to existing features go under Changed, never hidden under Fixed.294. Rewrite each line in plain words from the customer's side: what they can now do, or what now works. One line, no ticket numbers in the customer version.305. Write the internal version for support: every line plus known issues, workarounds, who is affected (segment, plan or setting) and where to escalate.316. For Security items, keep detail minimal and check with a qualified adviser before publishing specifics. Move anything not yet shipped to Unreleased.3233## Output Format34```markdown35# Release Notes36## [Version] [YYYY-MM-DD]37### Added38- [what customers can now do]39### Changed40- [behaviour that works differently now]41### Deprecated / Removed / Fixed / Security42- [line, plain words]43## Internal version for support44| Change | Who is affected | Known issue | Workaround | Escalate to |45|---|---|---|---|---|46| [change] | [segment / plan / setting] | [issue or none] | [workaround] | [role] |47## Unreleased48- [coming change, no date promised]49## Decision50[Named person] approves the customer notes before they are published on [date]; support receives the internal version by [date].51```5253## Done When54- Every customer line sits under one of the six change types55- No ticket numbers, commit messages or internal jargon in the customer version56- Removed and deprecated items say what to use instead57- Support has the internal version before customers see the notes5859## Quality Bar60- Never name a customer in the notes without their permission61- Changed behaviour is labelled Changed, even when it is embarrassing62- No invented dates, versions or fixes; unknowns stay in brackets63- Security wording is checked with a qualified adviser before publishing details64- A named person approves before notes are published.6566## Next67Run pm-success-metrics (Success Metrics) to check whether the change worked.6869## About the makers7071This pack is made by 90n ([90n.ai](https://90n.ai)): AI-native ways of working and tools for Product, Marketing and HR teams, built by ex-McKinsey founders. We map where time and money leak, redesign the work around AI and stay until your people run it themselves, and we run our own company on Claude. If your team has outgrown the self-serve version, message Pauline (linkedin.com/in/paulinebertry).