User: Password:
Subscribe / Log in / New account

In search of the perfect changelog

In search of the perfect changelog

Posted Apr 27, 2009 6:51 UTC (Mon) by kleptog (subscriber, #1183)
Parent article: In search of the perfect changelog

The thing I miss in most changelogs is that they often discuss what changed, while you can see that by looking at the patch. What you want is *why* it was changed. What is performance, a bug, a feature, some forgotten corner case, or something else?

The entries that bug me the most: "Refactor code XYZ" (sometimes with more words, but the result is the same). Completely useless, since it doesn't explain what was wrong with the old way or why the new way is better.

(Log in to post comments)

Copyright © 2017, Eklektix, Inc.
Comments and public postings are copyrighted by their creators.
Linux is a registered trademark of Linus Torvalds