[Top][All Lists]

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

Re: Summarizing the purpose of a change.

From: Karl Fogel
Subject: Re: Summarizing the purpose of a change.
Date: Sun, 22 Nov 2009 11:02:25 -0600
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/23.1.50 (gnu/linux)

Eli Zaretskii <address@hidden> writes:
>> > In many projects, there is a convention of summarizing the purpose of a
>> > change in one or two sentences at the start of the log entry.  This
>> > makes the rest of the log entry (and the change itself) easier to
>> > understand.
>> > Could we try that in Emacs?  Or is there some reason we don't do it?
>> I do this every time.  So far, nobody's complained.
> I do this when I commit large sets of changes.  It could be a nuisance
> to do that for simple changes in a single file, though.

Yup.  I'm talking about just the situation where a summary is necessary.
For an easy fix in a single file, the technical description of the
change can also be the summary -- no one needs more.  Only when the
change is not its own summary is a summary is needed.

So far, everyone who's chimed in has basically said "Yeah, I try to do
this".  But my question is more about making it policy, in the sense
that of making it appropriate to follow up to change saying "How about a
summary line for that?"


reply via email to

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