尊重程式碼

多元包容是 Fuchsia 文化的核心,我們的價值包括與彼此尊重和尊嚴。每個人都應該能貢獻一己之力 不必擔心偏誤和歧視這項有效的程式碼政策提供指引,協助您解決程式碼集、UI 和說明文件中可能出現的歧視或危害行為語言。

政策

應避免以直接或間接的方式避免貶抑、傷害或永久歧視的術語,並將取代原詞。

這項政策的適用範圍為何?

在 Fuchsia 作業中,貢獻者閱讀的任何內容,包括:

  • 變數、類型、函式、檔案、建構規則、二進位檔、匯出變數的名稱...
  • 測試資料
  • 系統輸出和螢幕
  • 說明文件 (來源檔案內外)
  • 修訂訊息

原則

  • 保持尊重:避免偏見和傷害。貶抑他人、有歧視或不必要的性別的語言不適合描述事物的運作方式。
  • 尊重文化上的敏感語言:某些字詞可能帶有顯著的歷史或政治意義。請留意這一點並採用替代選項

如何判斷特定術語是否安全?

應用上述原則。如有任何疑問,請傳送電子郵件至 fuchsia-community-managers@google.com。

有哪些不能使用的術語?

這些名單並「不」含括所有內容,其中包含說明文件中的常見範例如果發現令人反感的語言,請提出檢舉。

特定條款

字詞 建議替代方案
主要 主要, 控制器, 主要, 主機
奴隸 備用資源, 從屬, 次要, 追蹤者, 裝置, 週邊裝置
許可清單 許可清單、例外狀況清單、納入清單
列入黑名單 拒絕清單、封鎖清單、排除清單
瘋狂 出乎意料, 災難, 固有
神秘 預期, 適當, 合理, 有效
例行檢查 選取
太扯了 出乎意料, 災難, 固有
紅線 優先等級, 限制, 軟限制
白色手套 頂級服務;周全且完善的支援
停止期間 已封鎖
打造警察 打造園丁
dummy 預留位置

慣用語

使用描述性和事實的陳述,不要使用慣用語。成語可能會和上述問題相同,而且對文化背景與您不同的人也難以理解。

  • 舉例來說,您應使用「這更複雜」取代「這不是黑色或白色」。
  • 不要寫著「這視盲人」,而是闡明你要表達的意思,例如 「你指的參照有誤,因為 ...」

如果我遇到違反這項政策的術語,會怎麼樣?

實作程式碼時,如果和規格中的語言不同,可能會導致無法理解實作內容。在這種情況下,我們建議按照以下方式,以降低偏好順序:

  1. 如果使用替代術語不會幹擾理解,請使用替代術語。
  2. 失敗的話,請勿將術語傳播至執行互連網路的程式碼層外。如有需要,可以在 API 邊界使用替代術語。