Skip to content

Commit

Permalink
Merge pull request #1370 from vim-jp/hh-update-helphelp
Browse files Browse the repository at this point in the history
Update helphelp.{txt,jax}
h-east authored Nov 17, 2023
2 parents eaa17a8 + 85e4331 commit 0a89d63
Showing 2 changed files with 37 additions and 21 deletions.
30 changes: 19 additions & 11 deletions doc/helphelp.jax
Original file line number Diff line number Diff line change
@@ -389,17 +389,25 @@ Vim ヘルプファイルでは以下のものがそれぞれハイライトさ

詳細は $VIMRUNTIME/syntax/help.vim を見てください。

*inclusion*
Vim はみんなのもので、人種、性別、その他何も関係しません。一部の人々は、ユー
ザーに言及するときに "he" や "his" を使うことに大騒ぎし、我々がユーザーを男性
であると仮定しているかのように考えています。もちろんそういう意図ではありませ
ん、ヘルプテキストを書く際の習慣になっているだけで、多くの場合、何年も昔からそ
う書かれてます。また、多くの文章は、英語が第一言語{訳注: 母語のこと} ではない
貢献者によって書かれています。私たちはテキストの言い回しなどに関係なく、ユー
ザーのジェンダーがどうなのか仮定することはありません。そのような相談をする人達
は "they" を使うようにと提案しますが、しかしそれは通常の英語ではありません。そ
のような相談に多くの時間を費やしたくありません。目標は、読者が Vim がどのよう
に動くかの仕組みを理解することで、正しい言葉遣いは二の次です。

☆性別中立な言語

*gender-neutral* *inclusion*
Vim は、人種、性別などに関係なく、すべての人のためのものです。新規または更新さ
れたヘルプテキストについては、性別に依存しない言語を使用することをお勧めしま
す。一部のヘルプテキストは何年も前のものなので、変更する必要はありません。テキ
ストがどのように表現されているかにかかわらず、我々はユーザーの性別についていか
なる仮定も行いません。目標は、読者が Vim がどのように動作するかを理解すること
であり、正確な表現は二の次です。

多くのオンライン技術スタイルガイドには、性別に依存しない言語に関するセクション
が含まれています。以下にいくつか挙げます: >
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: 性別中立な言語では、単数形の "they" を使用する必要はありません。

vim:tw=78:ts=8:noet:ft=help:norl:
28 changes: 18 additions & 10 deletions en/helphelp.txt
Original file line number Diff line number Diff line change
@@ -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:

0 comments on commit 0a89d63

Please sign in to comment.