@@ -394,17 +394,25 @@ highlighting. So do these:
394
394
395
395
You can find the details in $VIMRUNTIME/syntax/help.vim
396
396
397
- *inclusion*
398
- Vim is for everybody, no matter race, gender or anything. Some people make a
399
- big deal about using "he" or "his" when referring to the user, thinking it
400
- means we assume the user is male. That is not the case, it's just a habit of
401
- writing help text, which quite often is many years old. Also, a lot of the
402
- text is written by contributors for whom English is not their first language.
403
- We do not make any assumptions about the gender of the user, no matter how the
404
- text is phrased. Some people have suggested using "they", but that is not
405
- regular English. We do not want to spend much time on this discussion. The
406
- goal is that the reader understands how Vim works, the exact wording is
397
+
398
+ GENDER NEUTRAL LANGUAGE
399
+
400
+ *gender-neutral* *inclusion*
401
+ Vim is for everybody, no matter race, gender or anything. For new or updated
402
+ help text, gender neutral language is recommended. Some of the help text is
403
+ many years old and there is no need to change it. We do not make any
404
+ assumptions about the gender of the user, no matter how the text is phrased.
405
+ The goal is that the reader understands how Vim works, the exact wording is
407
406
secondary.
408
407
408
+ Many online technical style guides include sections about gender neutral
409
+ language. Here are a few: >
410
+
411
+ https://developers.google.com/style/pronouns
412
+ https://techwhirl.com/gender-neutral-technical-writing/
413
+ https://www.skillsyouneed.com/write/gender-neutral-language.html
414
+ https://ualr.edu/writingcenter/avoid-sexist-language/
415
+ <
416
+ Note: gender neutral language does not require using singular "they".
409
417
410
418
vim:tw=78:ts=8:noet:ft=help:norl:
0 commit comments