Release Notes

Release notes accompany a particular version and are written for the people who use the product, not the people who built it. They translate raw commits and pull requests into benefit-first language, group the changes by type, and call out anything that requires the reader to act, such as a breaking change or a migration step.

Unlike a full changelog, release notes are selective. They highlight what matters in one release and leave out internal refactors, dependency bumps, and other invisible changes. A typical note opens with a version number, a date, and a one-line summary, then lists the changes under headings like Added, Improved, and Fixed.

Well-written release notes build trust, reduce support load, and make the value of a team's work visible. They are published in many forms, including hosted changelog pages, in-app feeds, email digests, and app store update descriptions.