尊重代碼
包容性是 V8 文化的核心，我們的價值觀包括以尊嚴對待彼此。因此，重要的是每個人都能在沒有偏見和歧視的危害影響下做出貢獻。然而，我們的程式碼庫、使用者介面和文件中的術語可能會使這種歧視永存。本文件制定了指導方針，旨在解決程式碼和文件中的不尊重術語。
政策 #
應避免使用直接或間接貶低、傷害或使歧視永存的術語。
本政策的範圍為何？#
協力廠商在使用 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 邊界使用替代術語。