Blog
Practical guides on writing changelogs and release notes, with templates and examples.
How to write a changelog (with examples)
A practical guide to writing a changelog people read: what to include, how to structure it, and a before and after example from raw commits.
Changelog vs release notes: what is the difference?
A changelog is the dated record of every change per version. Release notes explain a release to users. See the differences, examples and when to use each.
Keep a Changelog template (copy and paste)
A copy-and-paste Keep a Changelog template, the six change types, how to use the Unreleased section, and how it works with Semantic Versioning.
Release notes generators: 5 ways to automate release notes
How release notes generators work, five ways to automate them from git history, their limits, and what to check in AI-written notes before you publish.