Re: Template for commit messages - Mailing list pgsql-hackers

From Joshua D. Drake
Subject Re: Template for commit messages
Date
Msg-id 56AB9598.4000603@commandprompt.com
Whole thread Raw
In response to Re: Template for commit messages  (Heikki Linnakangas <hlinnaka@iki.fi>)
Responses Re: Template for commit messages  (Alvaro Herrera <alvherre@2ndquadrant.com>)
List pgsql-hackers
On 01/29/2016 02:59 AM, Heikki Linnakangas wrote:

>> Well, I think what people are asking for is precisely a fixed format,
>> and I do think there is value in that.  It's nice to capture the
>> nuance, but the nuance is going to get flattened out anyway when the
>> release notes are created.  If we all agree to use a fixed format,
>> then a bunch of work there that probably has to be done manually can
>> be automated.  However, if we all agree to use a fixed format except
>> for you, we might as well just forget the whole thing, because the
>> percentage of commits that are done by you is quite high.
>
> Before I agree to adding fixed format lines to my commits, I'd like to know exactly what people would want to do with
theinformation. "Bunch of work that probably could be automated" doesn't cut it. For example, if I tag someone as
"Reviewed-by",does it mean that his name will automatically appear in the release notes? Or if there's a bug, is the
reviewerthen somehow responsible for missing it?
 
>
> As a way of saying "thank you", I like a personalised, nuanced, message much better. True, we can do both. A good
thingabout processing the commit messages manually e.g  for compiling release notes is that there's human judgement on
whatto include.  Of course, that's a lot of work. Which is why I'd like to hear from whoever wants to make use of these
linesto explain in more detail what information they need,  and what they would do with it, to make sure that what we
addis actually useful, and that we don't add noise to the commit messages unnecessarily.
 
>
> - Heikki

I think the best question to ask is:

"What is the problem we are trying to solve?"

"A bunch of work that probably could be automated"

Does not answer that question.

Sincerely,

Joshua D. Drake


-- 
Command Prompt, Inc.                  http://the.postgres.company/                     +1-503-667-4564
PostgreSQL Centered full stack support, consulting and development.



pgsql-hackers by date:

Previous
From: Tom Lane
Date:
Subject: Re: Sequence Access Method WIP
Next
From: Anastasia Lubennikova
Date:
Subject: Re: [WIP] Effective storage of duplicates in B-tree index.