リスペクトのあるコード
インクルージョンは V8 のカルチャーの中心であり、私たちの価値観には互いに尊厳をもって接することも含まれています。このように、誰もがバイアスと差別による有害な影響に直面することなく貢献できることが重要です。しかし、コードベース、UI、ドキュメント内の用語は、その差別を永続させる可能性があります。このドキュメントは、コードとドキュメント内のリスペクトのない用語に対処することを目的としたガイドラインを定めています。
ポリシー #
直接的または間接的に差別を軽蔑、中傷、または永続させる用語は避ける必要があります。
このポリシーの対象とは？ #
コントリビューターが V8 で作業中に読む可能性のあるものすべて、以下を含みます。
- 変数、型、関数、ファイル、ビルドルール、バイナリ、エクスポートした変数などの名前、
- テストデータ
- システム出力と表示
- ドキュメント（ソースファイルの内外両方）
- コミットメッセージ
原則 #
- リスペクトしましょう: 物事の仕組みを説明するために軽蔑的な言葉は必要ありません。
- 文化的に配慮のある言葉を選びましょう: 一部の言葉には大きな歴史的または政治的意味が含まれる場合があります。これに留意して代替案を使用してください。
特定の用語が適切かどうかをどう判断したらよいですか？ #
上記の原則を適用してください。質問がある場合は、v8-dev@googlegroups.com までご連絡ください。
避けるべき用語の例を教えてください。 #
このリストは包括的なものではありません。人々が頻繁に遭遇する例がいくつか含まれています。
| 用語 | 推奨される代替案 |
|---|---|
| master | primary（プライマリ）、controller（コントローラー）、leader（リーダー）、host（ホスト） |
| slave | replica（レプリカ）、subordinate（従属）、secondary（セカンダリ）、follower（フォロワー）、device（デバイス）、peripheral（周辺機器） |
| whitelist | allowlist（許可リスト）、exception list（例外リスト）、inclusion list（包含リスト） |
| blacklist | denylist（拒否リスト）、blocklist（ブロックリスト）、exclusion list（除外リスト） |
| insane | unexpected（予期しない）、catastrophic（悲惨な）、incoherent（非論理的） |
| sane | expected（予期される）、appropriate（適切な）、sensible（賢明な）、valid（有効な） |
| crazy | unexpected（予期しない）、catastrophic（悲惨な）、incoherent（非論理的） |
| redline | priority line（優先ライン）、limit（制限）、soft limit（ソフト制限） |
このポリシーに違反する何かに接続する場合はどうすればよいですか？ #
この状況は、特に仕様を実装するコードで何度か発生しています。このような状況では、仕様の言語と異なることで、実装を理解する能力が損なわれる可能性があります。このような状況では、優先度の低い順に、次のいずれかの方法を提案します。
- 代替の用語を使用しても理解の妨げにならない場合、代替の用語を使用します。
- それができない場合は、インターフェースを実行するコード層を超えて用語を広めないでください。必要に応じて、API 境界で代替の用語を使用してください。