Anna Pickard, writing on the Slack blog, describes how Slack approaches writing release notes for their apps. In the modern App Store, Slack is one of the few companies that publishes good release notes – informative, just the right amount of funny, and detailed.
If you want to produce something that people will want to read, it’s only polite to make it enjoyable to read it. So in release notes — as in everything else we do — a large love for language, and a little humor, go a long way. Once you’ve gone that long way, it’s tempting to go further still, but we try and remind ourselves to hold back.
(Compare and contrast: the people who write release notes for Medium.)