[Top][All Lists]

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

Re: rationales in commit messages

From: Bruno Haible
Subject: Re: rationales in commit messages
Date: Tue, 03 Jan 2012 23:09:10 +0100
User-agent: KMail/4.7.4 (Linux/3.1.0-1.2-desktop; KDE/4.7.4; x86_64; ; )

Stefano Lattarini wrote:
> report in the commit message of your patch the useful and extensive
> arguments, explanations and references you have laid out so excellently in
> your mail.

Is it better to copy the arguments into a (long) commit message,
or add a reference to the mail(s) in the lists.gnu.org archive?

I tend to do the latter, because it allows future readers to recover
the entire context of the discussion thread, including arguments and
counter-arguments. But I'm open to either style.

Note: It may take an hour or two for a mail to appear in the lists.gnu.org
archives, but by the time a committer pushes a commit, he should have
waited a bit anyway. So I don't see this as a big problem.


reply via email to

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