translation: human page_type: lcat
报告问题 查看源代码 每夜 build · 8.0 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5
本页介绍了 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。
- 文档。在适用的情况下,功能贡献应包含文档更新。
如需详细了解如何为 Bazel 做出贡献,请参阅我们的贡献指南。