On Thu, Jul 15, 2021 at 12:25 PM Junio C Hamano <gitster@xxxxxxxxx> wrote: > 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. > 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.
