# HG changeset patch # User Christian Brabandt # Date 1699690503 -3600 # Node ID 35aaf01f7d6186eaa781f4617711be2f0b991200 # Parent 3fa35b791ae71aad530021f322f19646c929acd8 runtime(doc): clarify `:help inclusion` section Commit: https://github.com/vim/vim/commit/bee966d3fe96f20656183d260dd03f6abb11ad79 Author: Ernie Rael Date: Sat Nov 11 09:09:47 2023 +0100 runtime(doc): clarify `:help inclusion` section Signed-off-by: Ernie Rael Signed-off-by: Christian Brabandt diff --git a/runtime/doc/helphelp.txt b/runtime/doc/helphelp.txt --- a/runtime/doc/helphelp.txt +++ b/runtime/doc/helphelp.txt @@ -394,17 +394,25 @@ highlighting. So do these: You can find the details in $VIMRUNTIME/syntax/help.vim - *inclusion* -Vim is for everybody, no matter race, gender or anything. Some people make a -big deal about using "he" or "his" when referring to the user, thinking it -means we assume the user is male. That is not the case, it's just a habit of -writing help text, which quite often is many years old. Also, a lot of the -text is written by contributors for whom English is not their first language. -We do not make any assumptions about the gender of the user, no matter how the -text is phrased. Some people have suggested using "they", but that is not -regular English. We do not want to spend much time on this discussion. The -goal is that the reader understands how Vim works, the exact wording is + +GENDER NEUTRAL LANGUAGE + + *gender-neutral* *inclusion* +Vim is for everybody, no matter race, gender or anything. For new or updated +help text, gender neutral language is recommended. Some of the help text is +many years old and there is no need to change it. We do not make any +assumptions about the gender of the user, no matter how the text is phrased. +The goal is that the reader understands how Vim works, the exact wording is secondary. +Many online technical style guides include sections about gender neutral +language. Here are a few: > + + https://developers.google.com/style/pronouns + https://techwhirl.com/gender-neutral-technical-writing/ + https://www.skillsyouneed.com/write/gender-neutral-language.html + https://ualr.edu/writingcenter/avoid-sexist-language/ +< +Note: gender neutral language does not require using singular "they". vim:tw=78:ts=8:noet:ft=help:norl: diff --git a/runtime/doc/tags b/runtime/doc/tags --- a/runtime/doc/tags +++ b/runtime/doc/tags @@ -7670,6 +7670,7 @@ gd pattern.txt /*gd* gdb debug.txt /*gdb* gdb-version terminal.txt /*gdb-version* ge motion.txt /*ge* +gender-neutral helphelp.txt /*gender-neutral* get() builtin.txt /*get()* get-ms-debuggers debug.txt /*get-ms-debuggers* getbufinfo() builtin.txt /*getbufinfo()*