How to build an online community →
The Wall.fm Blog home.
Shipping
Most users skim release notes in seconds. Learning how to write release notes well means putting the change they will notice at the top, in plain words.
Big launches need a different shape again: a “2.0 is here” announcement explains why, not just what.
Four habits.
When it is a 2.0.
Under Semantic Versioning, a major version signals changes that are not backwards compatible. For users, say what moved, what is new and what they need to do, in that order.
| Section | Content |
|---|---|
| Headline | Version 2.0 is here |
| Why | the problem the release solves |
| Top three changes | one screenshot each |
| What you need to do | nothing, or a short list |
Where the facts on this page come from.
External reference · keepachangelog.com
Changelog conventions.
External reference · semver.org
MAJOR.MINOR.PATCH rules.