多元包容是 Fuchsia 文化的核心,我們的價值包括與彼此尊重和尊嚴。每個人都應該能貢獻一己之力 不必擔心偏誤和歧視這項有效的程式碼政策提供指引,協助您解決程式碼集、UI 和說明文件中可能出現的歧視或危害行為語言。
政策
應避免以直接或間接的方式避免貶抑、傷害或永久歧視的術語,並將取代原詞。
這項政策的適用範圍為何?
在 Fuchsia 作業中,貢獻者閱讀的任何內容,包括:
- 變數、類型、函式、檔案、建構規則、二進位檔、匯出變數的名稱...
- 測試資料
- 系統輸出和螢幕
- 說明文件 (來源檔案內外)
- 修訂訊息
原則
- 保持尊重:避免偏見和傷害。貶抑他人、有歧視或不必要的性別的語言不適合描述事物的運作方式。
- 尊重文化上的敏感語言:某些字詞可能帶有顯著的歷史或政治意義。請留意這一點並採用替代選項
如何判斷特定術語是否安全?
應用上述原則。如有任何疑問,請傳送電子郵件至 fuchsia-community-managers@google.com。
有哪些不能使用的術語?
這些名單並「不」含括所有內容,其中包含說明文件中的常見範例如果發現令人反感的語言,請提出檢舉。
特定條款
字詞 | 建議替代方案 |
---|---|
主要 | 主要, 控制器, 主要, 主機 |
奴隸 | 備用資源, 從屬, 次要, 追蹤者, 裝置, 週邊裝置 |
許可清單 | 許可清單、例外狀況清單、納入清單 |
列入黑名單 | 拒絕清單、封鎖清單、排除清單 |
瘋狂 | 出乎意料, 災難, 固有 |
神秘 | 預期, 適當, 合理, 有效 |
例行檢查 | 選取 |
太扯了 | 出乎意料, 災難, 固有 |
紅線 | 優先等級, 限制, 軟限制 |
白色手套 | 頂級服務;周全且完善的支援 |
停止期間 | 已封鎖 |
打造警察 | 打造園丁 |
dummy | 預留位置 |
慣用語
使用描述性和事實的陳述,不要使用慣用語。成語可能會和上述問題相同,而且對文化背景與您不同的人也難以理解。
- 舉例來說,您應使用「這更複雜」取代「這不是黑色或白色」。
- 不要寫著「這視盲人」,而是闡明你要表達的意思,例如 「你指的參照有誤,因為 ...」
如果我遇到違反這項政策的術語,會怎麼樣?
實作程式碼時,如果和規格中的語言不同,可能會導致無法理解實作內容。在這種情況下,我們建議按照以下方式,以降低偏好順序:
- 如果使用替代術語不會幹擾理解,請使用替代術語。
- 失敗的話,請勿將術語傳播至執行互連網路的程式碼層外。如有需要,可以在 API 邊界使用替代術語。