ChangeLog entry complexity

[Petr Baudis]

  Hi!

On Mon, Mar 25, 2013 at 12:55:46PM -0400, Carlos O'Donell wrote:
> There was some good discussion recently on a Google+ thread I started
> regarding the tradition of writing detailed change notes.
> 
> https://plus.google.com/u/0/116746191356411907058/posts/1L8kb4LRsst
> 
> Does anyone feel strongly that detailed change logs are limiting our
> acceptance of new developers to the community?

  I think writing detailed change logs is absolutely great. For example,
browsing the history of the Git version control system or (mostly) the
Linux kernel is quite pleasurable and you have a good chance of learning
the complete background and all else you need to know about a change
from the Git history.

  But that is very different from the ChangeLogs, which just describe
*what* has been changed in great detail, something quite obvious from
the diffs themselves.

				Petr "Pasky" Baudis