Skip to content

Commit 0a89d63

Browse files
authored
Merge pull request #1370 from vim-jp/hh-update-helphelp
Update helphelp.{txt,jax}
2 parents eaa17a8 + 85e4331 commit 0a89d63

File tree

2 files changed

+37
-21
lines changed

2 files changed

+37
-21
lines changed

doc/helphelp.jax

Lines changed: 19 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -389,17 +389,25 @@ Vim ヘルプファイルでは以下のものがそれぞれハイライトさ
389389

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

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

393+
☆性別中立な言語
394+
395+
*gender-neutral* *inclusion*
396+
Vim は、人種、性別などに関係なく、すべての人のためのものです。新規または更新さ
397+
れたヘルプテキストについては、性別に依存しない言語を使用することをお勧めしま
398+
す。一部のヘルプテキストは何年も前のものなので、変更する必要はありません。テキ
399+
ストがどのように表現されているかにかかわらず、我々はユーザーの性別についていか
400+
なる仮定も行いません。目標は、読者が Vim がどのように動作するかを理解すること
401+
であり、正確な表現は二の次です。
402+
403+
多くのオンライン技術スタイルガイドには、性別に依存しない言語に関するセクション
404+
が含まれています。以下にいくつか挙げます: >
405+
406+
https://developers.google.com/style/pronouns
407+
https://techwhirl.com/gender-neutral-technical-writing/
408+
https://www.skillsyouneed.com/write/gender-neutral-language.html
409+
https://ualr.edu/writingcenter/avoid-sexist-language/
410+
<
411+
Note: 性別中立な言語では、単数形の "they" を使用する必要はありません。
404412

405413
vim:tw=78:ts=8:noet:ft=help:norl:

en/helphelp.txt

Lines changed: 18 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -394,17 +394,25 @@ highlighting. So do these:
394394

395395
You can find the details in $VIMRUNTIME/syntax/help.vim
396396

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
407406
secondary.
408407

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".
409417

410418
vim:tw=78:ts=8:noet:ft=help:norl:

0 commit comments

Comments
 (0)