尊重代码

包容性是 Fuchsia 文化的核心,我们的价值观包括尊重和尊严。每个人都应该为 Fuchsia 贡献自己的力量,同时避免偏见和歧视的危害。 这项尊重代码政策提供了相关指南,可说明如何在代码库、界面和文档中解决可能导致歧视或伤害行为的语言。

政策

应避免使用直接或间接诋毁、伤害或持久歧视歧视的术语,并应予以替换。

该政策的适用范围

贡献者在处理 Fuchsia 时会阅读的所有内容,包括:

  • 变量、类型、函数、文件、构建规则、二进制文件、导出的变量的名称...
  • 测试数据
  • 系统输出和显示内容
  • 文档(源文件内外)
  • 提交说明

原则

  • 相互尊重:避免偏见和伤害行为。诋毁性、体能歧视或不必要地区分性别的语言对于描述事情的工作原理没有帮助。
  • 尊重具有文化敏感性的语言:某些字词可能具有重要的历史意义或政治意义。请注意这一点并使用替代方案。

如何判断特定术语是否使用得当?

以上述原则为准。如果您有任何疑问,请发送电子邮件至 fuchsia-community-managers@google.com。

应避免使用的术语示例有哪些?

这些列表并不详尽。其中包含文档中的常见示例。如果您看到冒犯性语言,请举报。

具体术语

术语 建议的替代值
master 主要、控制器、主要、主机
奴隶 副本, 从属, 次要, 跟随, 设备, 外围设备,
whitelist 许可名单、例外列表、包含列表
blacklist 拒绝名单、屏蔽名单、排除列表
疯了 出人意料, 灾难性, 不一致
健康 预期、适当、合理、有效
健全性检查 选中
疯了 出人意料, 灾难性, 不一致
红线 优先级行, 限制, 软限制, priority line, limit, soft limit
白手套 顶级服务;细致、全面的支持
涂黑 被阻挡
组建警察 构建园丁
dummy 占位符

习语

使用描述性和事实性陈述,而不是习语。习语可能会遭遇上述问题,并且对于文化背景与您不同的人来说,习语可能也难以理解。

  • 例如,不要使用“这不是黑色或白色”,而应使用“这更精细”。
  • 不要使用“这是盲人领导盲人”,而是要像这样说“你提到的参考内容不准确,因为 ...”

如果我遇到违反此政策的术语,该怎么办?

在实现代码时,如果使用的语言与规范中的语言不同,则可能会导致我们无法理解相应实现。在这些情况下,我们建议按照从低到高的顺序采取以下措施之一:

  1. 如果使用替代术语不影响用户理解,请使用替代术语。
  2. 如果不能,请不要将术语传播到执行对接的代码层之外。如有必要,请在 API 边界上使用替代术语。