Re: [PATCH 1/4] Documentation: use singular they when appropriate

On 07/06/2021 19:32, Derrick Stolee wrote:

On 6/7/2021 1:09 PM, Ævar Arnfjörð Bjarmason wrote:

quoted

On Mon, Jun 07 2021, Derrick Stolee via GitGitGadget wrote:

quoted

From: Derrick Stolee <redacted>

There are several instances in our documentation where we refer to an
anonymous user as "a contributor" or "an integrator" or similar. To
avoid repeating this role, pronouns are used. Previous examples
chose a gender for this user, using "he/him" or "she/her" arbitrarily.

Replace these uses with "they/them" to ensure that these documentation
examples apply to all potential users without exception.

Signed-off-by: Derrick Stolee <redacted>

I think this is mostly an improvement, however:

quoted

  .../using-signed-tag-in-pull-request.txt      | 38 +++++++++----------

This is a quote from a mail of Junio's[1] (date and all). I don't think
it makes sense to copyedit that after the fact without at least editing
the header that indicates that it's a verbatim reproduction.

1. https://lore.kernel.org/git/7vehuyosaa.fsf@alter.siamese.dyndns.org/ (local)

That's a good point. It does look a little strange that there is
an email in our Documentation/ directory. I wondered if this was
included in the docs that get posted to git-scm.com, but I see that
the link I manually constructed [1] redirects to the GitHub mirror.

[1] https://git-scm.com/docs/howto/using-signed-tag-in-pull-request.txt

As long as this file remains formatted as an archived email message,
the edits here are inappropriate.

To be fair, this file has already been copyedited once in commit
2de9b71138 (Documentation: the name of the system is 'Git', not 'git', 2013-01-21)

It's another question of whether the
files within Documentation/howto should be updated to be docs that can
be more easily posted in places like git-scm.com.

For now, I'll remove these edits from the patch.