git.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: Derrick Stolee <stolee@gmail.com>
To: Felipe Contreras <felipe.contreras@gmail.com>, git@vger.kernel.org
Cc: "Ævar Arnfjörð Bjarmason" <avarab@gmail.com>,
	"Junio C Hamano" <gitster@pobox.com>,
	"Derrick Stolee" <dstolee@microsoft.com>
Subject: Re: [PATCH 1/2] doc: avoid using the gender of other people
Date: Tue, 15 Jun 2021 09:28:14 -0400	[thread overview]
Message-ID: <94848796-1a7f-e1d2-fcf7-5e6f5f361f2a@gmail.com> (raw)
In-Reply-To: <20210611202819.47077-2-felipe.contreras@gmail.com>

On 6/11/2021 4:28 PM, Felipe Contreras wrote:
> Some people have a problem with using a female reviewer or a female
> developer as an example, and since this is an irrelevant detail, let's
> say goodbye to our illustrative female colleagues.

I find this message to be snarky and underhanded instead of
actually describing the goals at hand. Citing the reason as
stated is _not_ the purpose of these gender-neutral
recommendations.

Instead, a message such as this could apply:

  Using gendered pronouns for an anonymous person applies a
  gender where none is known, and further excludes readers
  who do not use gendered pronouns. Avoid such examples in
  the documentation by using "they" or passive voice to
  avoid the need for a pronoun.

The textual edits in the patch are correct.

-Stolee

  reply	other threads:[~2021-06-15 13:28 UTC|newest]

Thread overview: 14+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-06-11 20:28 [PATCH 0/2] Avoid gender pronouns Felipe Contreras
2021-06-11 20:28 ` [PATCH 1/2] doc: avoid using the gender of other people Felipe Contreras
2021-06-15 13:28   ` Derrick Stolee [this message]
2021-06-15 16:30     ` Felipe Contreras
2021-06-11 20:28 ` [PATCH 2/2] comments: avoid using the gender of our users Felipe Contreras
2021-06-15 13:31   ` Derrick Stolee
2021-06-15 14:16     ` Paul Smith
2021-06-15 16:39       ` Felipe Contreras
2021-06-15 16:36     ` Felipe Contreras
2021-06-12  1:17 ` [PATCH 0/2] Avoid gender pronouns Bagas Sanjaya
2021-06-12  1:39   ` Felipe Contreras
2021-06-12 23:24 ` Robert Karszniewicz
2021-06-13  7:15 ` Ævar Arnfjörð Bjarmason
2021-06-14  1:27   ` Junio C Hamano

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:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

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

  git send-email \
    --in-reply-to=94848796-1a7f-e1d2-fcf7-5e6f5f361f2a@gmail.com \
    --to=stolee@gmail.com \
    --cc=avarab@gmail.com \
    --cc=dstolee@microsoft.com \
    --cc=felipe.contreras@gmail.com \
    --cc=git@vger.kernel.org \
    --cc=gitster@pobox.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* 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.
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).