News for hackers. Stuff that matters.

Ask HN: Let's talk release notes

What's your experience with release notes?

Do you find them valuable? Tips and tricks. Great examples of release notes. What do you hate?

( 1 comment | 2 points | on HN )
Re:Ask HN: Let's talk release notes by cpburns2009 on Wednesday February 15, 2017 @09:34PM (#13657404)
I find them invaluable as a programmer who also has to maintain systems. It gives me a rough idea if upgrading software and libraries should be relatively painless or a long endeavor. I like Apache Solr's release notes because they're well sectioned. A giant, unorganized change-log, while better than nothing, is not ideal.