Re: Using VC for change descriptions

[Joseph Myers]

On Mon, 27 Nov 2017, Mike Gerwitz wrote:

> This is what I do with my projects now.  Guix and Emacs do this well
> too, for example.  To Richard's point: while Git provides a wealth of
> information and tools to process it, it sucks looking over diffs when
> you want a high-level overview of what changed.

It's important to have commit messages that provide that high-level 
overview.  The problem I'm concerned with is that the ChangeLog format 
forces descriptions at the level of individual files and named entities 
therein, and for many changes that's not a high-level overview, it's a 
low-level repetition of the diffs in English, which is less useful than 
either the proper high-level overview that also has to be written, or the 
diffs themselves for the details of exactly what changed in any given 
place.

-- 
Joseph S. Myers
address@hidden