Thread (76 messages) 76 messages, 13 authors, 2021-06-25

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

flat view

From: Emily Shaffer <hidden>
Date: 2021-06-08 17:33:54

On Mon, Jun 07, 2021 at 04:57:45PM +0000, Derrick Stolee via GitGitGadget wrote:

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.
(I am not disagreeing with the series.)

There is value in intentionally defaulting to "she/her", especially in
settings where women are underrepresented. It can be a nice way to
shake the foundations of unconscious bias in the reader's head. See
https://www.askamanager.org/2011/07/why-i-refer-to-everyone-as-she.html
as an example.
Replace these uses with "they/them" to ensure that these documentation
examples apply to all potential users without exception.
However, in this case, I think "they/them" is appropriate as a default.
As you say, this documentation is intended as a guide to potential users
and contributors, and should apply to them. Thanks for writing the
change.

Reviewed-by: Emily Shaffer <redacted>
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help