捐赠政策

translation: human page_type: lcat

本页介绍了 Bazel 的治理模式和贡献政策。

治理模式

Bazel 项目由 Google 领导和管理 并且拥有大量 Google 外部的贡献者社区。一些 Bazel 组件(例如 bazelbuild组织下的特定规则代码库)由社区成员领导、 维护和管理。Google Bazel 团队 会审核将社区拥有的代码库(例如规则)添加到 bazelbuild GitHub 组织的建议。

贡献者角色

以下是 Bazel 项目中角色的概要,包括其职责:

  • 所有者:Google Bazel 团队。所有者负责:
    • Bazel 项目的策略、维护和领导。
    • 构建和维护 Bazel 的核心功能。
    • 任命维护人员并批准新的代码库。
  • 维护人员:Google Bazel 团队和指定的 GitHub 用户。 维护人员负责:
    • 构建和维护其代码库的主要功能。
    • 审核并批准对 Bazel 代码库区域的贡献。
    • 通过及时且透明的问题管理、PR 审核和文档,为用户和贡献者提供支持。
    • 发布、测试并与 Bazel 所有者协作。
  • 贡献者:所有为 Bazel 项目 贡献代码或文档的用户。
    • 创建编写良好的 PR,为 Bazel 的代码库和文档做出贡献。
    • 使用标准渠道(例如 GitHub 问题)提出更改建议和报告问题。

成为维护人员

Bazel 所有者可以任命维护人员来领导明确定义的代码区域,例如规则集。如果贡献者过去有持续负责任的贡献记录,并且计划在未来做出重大贡献,则可以考虑成为合格的维护人员。

贡献政策

Bazel 项目接受外部贡献者的贡献。以下是 Google 管理和社区管理的代码区域的贡献政策。

  • 许可 。所有维护人员和贡献者都必须签署 Google 的贡献者许可协议
  • 贡献 。所有者和维护人员应尽一切努力接受有价值的贡献。所有贡献都必须:
    • 编写良好且经过充分测试
    • 由相关代码区域的维护人员讨论和批准。 讨论和批准在 GitHub 问题和 GitHub PR 中进行。 较大的贡献需要进行 设计审核
    • 添加到 Bazel 的持续集成系统(如果尚未添加)。
    • 可支持且与 Bazel 产品方向一致
  • 代码审核 。所有 bazelbuild 代码库中的所有更改都需要审核:
    • 所有 PR 都必须由所有者或维护人员批准。
    • 只有所有者和维护人员可以合并 PR。
  • 兼容性 。如果更改需要对 Google 内部系统进行重大修改,所有者可能需要拒绝 PR 或请求修改 PR(这种情况不太可能发生)。
  • 文档 。如果相关,功能贡献应包括文档更新。

如需详细了解如何为 Bazel 做出贡献,请参阅我们的 贡献指南