Write release notes people actually read — organised by what changed for the user, leading with impact, and honest about breakage. Use when writing a changelog, release notes, or a "what's new" post.
--- name: write-release-notes category: business description: >- Write release notes people actually read — organised by what changed for the user, leading with impact, and honest about breakage. Use when writing a changelog, release notes, or a "what's new" post. --- # Write Release Notes Most release notes are a commit log with the hashes removed. Nobody reads them, so nobody learns the feature exists, so the feature may as well not have shipped. The test for a release note is simple: **would a user change what they do tomorrow after reading this?** ## Organise by audience impact, not by system Not this: ``` - Updated auth service to v2.3 - Refactored the notification queue - Bumped dependencies ``` This: ``` ## New - **Sign in with a passkey.** No password to remember. Enable it in Settings → Security.
You are reading the opening of this skill.
The rest is open to any signed-in account — free included. Reading the library costs nothing.
Shared publicly by the author and open for any use. See the Terms.