Re: [PATCH] CodingGuidelines: recommend gender-neutral description
On Thu, Jul 15, 2021 at 12:25 PM Junio C Hamano <gitster@pobox.com> wrote:
Show 9 quoted lines
> Technical writing seeks to convey information with minimal
> friction. One way that a reader can experience friction is if they
> encounter a description of "a user" that is later simplified using a
> gendered pronoun. If the reader does not consider that pronoun to
> apply to them, then they can experience cognitive dissonance that
> removes focus from the information.
>
> Give some basic tips to guide us avoid unnecessary of gendered
> description.
Some words seem to be missing from this sentence.
Show 6 quoted lines
> diff --git a/Documentation/CodingGuidelines b/Documentation/CodingGuidelines
> @@ -541,6 +541,49 @@ Writing Documentation:
> + A contributor asks their upstream to pull from them.
> +
> + Note that this sounds ungrammatical and unnatural to those who
> + learned English as a second language in some parts of the world.
It also sounds ungrammatical and unnatural to this native English speaker.
Eric Sunshine <sunshine@sunshineco.com>