aniani/vim
0
0
Fork 1
mirror of https://github.com/vim/vim.git synced 2025-10-31 09:57:14 -04:00
Code Activity

runtime(doc): clarify :help inclusion section

Browse Source 
Signed-off-by: Ernie Rael <errael@raelity.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
This commit is contained in:
Ernie Rael
2023-11-11 09:09:47 +01:00
committed by Christian Brabandt
parent cb5e7a2026
commit bee966d3fe
2 changed files with 19 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
runtime/doc/helphelp.txt
View File

@@ -394,17 +394,25 @@ highlighting. So do these:
You can find the details in $VIMRUNTIME/syntax/help.vim 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 GENDER NEUTRAL LANGUAGE
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 *gender-neutral* *inclusion*
writing help text, which quite often is many years old. Also, a lot of the Vim is for everybody, no matter race, gender or anything. For new or updated
text is written by contributors for whom English is not their first language. help text, gender neutral language is recommended. Some of the help text is
We do not make any assumptions about the gender of the user, no matter how the many years old and there is no need to change it. We do not make any
text is phrased. Some people have suggested using "they", but that is not assumptions about the gender of the user, no matter how the text is phrased.
regular English. We do not want to spend much time on this discussion. The The goal is that the reader understands how Vim works, the exact wording is
goal is that the reader understands how Vim works, the exact wording is
secondary. 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: vim:tw=78:ts=8:noet:ft=help:norl:

1
runtime/doc/tags
View File

@@ -7670,6 +7670,7 @@ gd pattern.txt /*gd*
gdb debug.txt /*gdb* gdb debug.txt /*gdb*
gdb-version terminal.txt /*gdb-version* gdb-version terminal.txt /*gdb-version*
ge motion.txt /*ge* ge motion.txt /*ge*
gender-neutral helphelp.txt /*gender-neutral*
get() builtin.txt /*get()* get() builtin.txt /*get()*
get-ms-debuggers debug.txt /*get-ms-debuggers* get-ms-debuggers debug.txt /*get-ms-debuggers*
getbufinfo() builtin.txt /*getbufinfo()* getbufinfo() builtin.txt /*getbufinfo()*