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 做出贡献,请参阅我们的 贡献指南。