Re: [PATCH 4/4] CodingGuidelines: recommend singular they

> > If the reader does not consider that pronoun to apply to them,
> > then they can experience cognitive dissonance that removes focus from
> > the information. [...]
> > When choosing a gendered pronoun, that pronoun no longer applies to
> > nearly half of possible readers. Even if we alternated between "he/him"
> > and "she/her" perfectly evenly, we would still expect male and female
> > readers to experience an incorrect pronoun half the time. However, some
> > readers will not prescribe to either of these binary genders. Those
> > readers hence suffer an incorrect pronoun the entire time. Singular
> > "they" applies to every reader.
> 
> I'd expect most people to not actively read technical documentation and
> try to personally actively ascribe themselves to prose that clearly
> forms an example of something they may or may not do.
> 
> If that is how people commonly read documentation and find it
> off-putting I'd expect gendered language to be the least of our
> problems, since even with s/\bhe|she\b/they/g so much of what's left is
> still referring to hypothetical situations most users won't want to find
> themselves in.
> 
> Maybe I'm overthinking this, but per the above I'd think if this is a
> problem with losing the reader that we'd need more structural solutions
> to it in the common case, e.g. more guarded language that you should not
> read further if you don't care about XYZ aspect of the technical feature
> we're about to discuss.