Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

Release notes, what for? [closed]

What are release notes for and who reads them? Should/could they be automated by just spitting out bug fixes for the current release, or do they warrant careful human editing? So, anybody with a link to best practices(reasoning behind) in regards to software release notes?

like image 832
Ville M Avatar asked Nov 24 '08 21:11

Ville M


2 Answers

Bugfixes and added features. Users will read them to determine if they should go to the trouble of installing an incremental upgrade, or wait until the next release because this one doesn't add any features they need or fix any bugs in features that they were using.

I'd say they at least require a human to read through them and make sure that each note is useful. It depends how good the comments on your bug fixes are.

like image 109
Adam Jaskiewicz Avatar answered Sep 24 '22 02:09

Adam Jaskiewicz


Release notes are also important to your testing organization (if you have one), so that they know what's changed in the release and needs testing.

like image 27
Patrick Cuff Avatar answered Sep 24 '22 02:09

Patrick Cuff