[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Commit netiquette.

From: Stephen J. Turnbull
Subject: Re: Commit netiquette.
Date: Fri, 19 Feb 2010 09:22:29 +0900

Óscar Fuentes writes:

 > On this respect I find changelog entries as a lame way of documenting
 > changes.

Some senior developers are used to this method, and they are already
familiar with the code base.  It works well enough, regardless of your

The real issues you should be pointing to are (1) accurate commit log
messages are an excellent way to learn about the code base, so the
Emacs infrastructure (edit-log, vc) should try to ensure that commit
logs are as detailed as ChangeLog entries, and (2) ChangeLogs are a
minor but very persistent annoyance (especially to people doing
integrative work, like the maintainers) because they *very* frequently
require special handling, such as merge conflict resolution.

(1) should be easy enough to achieve, but (2) will require balancing
the interests of those used to ChangeLogs with their deficiencies.

reply via email to

[Prev in Thread] Current Thread [Next in Thread]