public inbox for [email protected]  

help / color / mirror / Atom feed

From: John Naylor <[email protected]>
To: Bruce Momjian <[email protected]>
Cc: Tom Lane <[email protected]>
Cc: Andres Freund <[email protected]>
Cc: Álvaro Herrera <[email protected]>
Cc: Peter Geoghegan <[email protected]>
Cc: Andrey Borodin <[email protected]>
Cc: PostgreSQL-development <[email protected]>
Subject: Re: PG 19 release notes and authors
Date: Mon, 6 Apr 2026 21:47:32 +0700
Message-ID: <CANWCAZYtUp0y8A0Viz05sJQXsaFj8DqHLnAvY8-jsMj=YWoxXw@mail.gmail.com> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>
	<[email protected]>
	<xgwkagej6rzkxg235ol4vzq3dljvaumzk3lhfecld4hogl4od5@mq6jaccjoxvz>
	<[email protected]>
	<[email protected]>
	<[email protected]>

On Mon, Apr 6, 2026 at 9:30 PM Bruce Momjian <[email protected]> wrote:
> I now realize the Commit Message Guidance used during PG 19 was unclear;
> it was:
>
>         Used to indicate the patch authors.  "Co-authored-by:" is used by
>         committers when they want to give full credit to the named individuals,
>         but also indicate that they made significant changes.
>
> I doesn't really say we are giving credit to "Author" individuals but
> list committers as co-authors with no credit, so that bad wording is on
> me.  It should have said:
>
>         Used to indicate the patch authors.  "Co-authored-by:" is to list
>         committers when they want to give full credit to the "Author"
>         individuals, but also indicate that they made significant changes.

That's not how I interpreted it at all, and after seeing commits with
both "Author" and "Co-authored-by" I am equally confused as to how
people are interpreting it.

> I think having "Co-authored-by:" mean one thing when "Author" appears
> and a different thing when "Author" is missing is too confusing.

My take is that the co-author tag has backfired and made things less
clear. If we are using it inconsistently, then it doesn't convey any
useful information. I'd actually rather just use "Author" exclusively
and if there is some further detail that needs to be conveyed, it can
be in the message body.

--
John Naylor
Amazon Web Services

view thread (53+ messages)  latest in thread

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected]
  Subject: Re: PG 19 release notes and authors
  In-Reply-To: <CANWCAZYtUp0y8A0Viz05sJQXsaFj8DqHLnAvY8-jsMj=YWoxXw@mail.gmail.com>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox