Docket Blog: Changelogs & Releases

CHANGELOGS Semantic versioning and your changelog The version number and the changelog entry are supposed to agree with each other, and most of the value is lost the moment they do not. Last updated 23 August 2026 · 6 min read

CHANGELOGS Release notes templates Six fill-in templates for six different kinds of release, each shown filled in. Last updated 23 August 2026 · 6 min read

CHANGELOGS How to write patch notes Patch notes and release notes read like the same thing until you write one, and the differences are exactly where most patch notes go wrong. Last updated 23 August 2026 · 6 min read

CHANGELOGS Changelog page design A working taxonomy of changelog page layouts, what each one suits, and the specific way each one breaks. Last updated 23 August 2026 · 6 min read

CHANGELOGS Best release notes tools A changelog is a page you maintain. Release notes are something you send. Sorted by how the update reaches the reader, not by feature count. Last updated 23 August 2026 · 8 min read

CHANGELOGS Release notes examples people read Five patterns that separate a changelog people skim from one they ignore. Last updated 23 August 2026 · 7 min read

CHANGELOGS Keep a Changelog, explained The six change types, the Unreleased section, and when the convention is worth it. Last updated 23 August 2026 · 6 min read

CHANGELOGS How to write release notes Who they are for, what to leave out, and how to write the effect rather than the fix. Last updated 23 August 2026 · 7 min read

CHANGELOGS Changelogs and release notes What a changelog is, how it differs from release notes and a roadmap, and how to run one well. Last updated 23 August 2026 · 10 min read

CHANGELOGS Changelog examples worth copying The patterns behind a changelog people read, with entries you can copy. Last updated 23 August 2026 · 6 min read

CHANGELOGS Best changelog tools in 2026 Every real way to publish a changelog, priced and rated against each vendor's own page. Last updated 23 August 2026 · 10 min read