help / color / mirror / code / Atom feed
From: "Daniel Shahaf" <d.s@daniel.shahaf.name>
To: zsh-workers@zsh.org
Subject: Re: ChangeLog entry: Author or Commttier?
Date: Thu, 22 Sep 2022 07:13:59 +0000	[thread overview]
Message-ID: <05666e30-c17d-43f6-916e-e9d8d9ed6948@www.fastmail.com> (raw)
In-Reply-To: <B64023EC-3845-4388-A5A3-8252CCA589B5@kba.biglobe.ne.jp>

[reordering the quote]

Jun T wrote on Tue, 20 Sep 2022 06:56 +00:00:
> If I remember correctly the name of the Committer was used before,
> but it seems Author's name is used recently.

I think it changes not as a function of time but as a function of
committer.  E.g., my ChangeLog script sets the changelog author to the
git author.

> When creating a ChangeLog entry, should I use the name of the
> Author of the patch, or of the Committer?

Putting the author's name in the ChangeLog author place makes for
fewer differences between people with a commit bit and people without
one.  That's consistent with the gist of guidelines elsewhere, e.g., Freenode's
[I didn't check Libera's] "don't wear the op hat whilst not using it" and Apache's
"don't use @author tags in source files".

(I'm not advocating for a particular option; I'm just presenting one argument.)



      parent reply	other threads:[~2022-09-22  7:19 UTC|newest]

Thread overview: 3+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2022-09-20  6:56 Jun T
2022-09-20 19:54 ` Bart Schaefer
2022-09-22  7:13 ` Daniel Shahaf [this message]

Reply instructions:

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

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

  Avoid top-posting and favor interleaved quoting:

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=05666e30-c17d-43f6-916e-e9d8d9ed6948@www.fastmail.com \
    --to=d.s@daniel.shahaf.name \
    --cc=zsh-workers@zsh.org \


* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox


This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).