[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.
Bruno
- Re: Don't use the abbreviation "win" to refer to Windows., (continued)
Re: [PATCH] Don't use the abbreviation "win" to refer to Windows., Bruno Haible, 2012/01/02
Re: [PATCH] Don't use the abbreviation "win" to refer to Windows., Paul Eggert, 2012/01/04
Re: [PATCH] Don't use the abbreviation "win" to refer to Windows., Bruno Haible, 2012/01/06