A changelog is the only page that proves an app is alive. Most are written for the team that made the changes. Ours is written for the person who will notice them.
Our rules
Lead with what you will notice, not what we did.
Give a number whenever there is one.
Say sorry when a bug was ours.
One release, one idea. Everything else is a bullet.
Each entry gets a version, a type (Feature, Improvement or Fix) and a one-line title that would still make sense in a year.
If a release note needs the word “various”, it is not ready.