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 或请求修改。
- 文档。在相关情况下,功能贡献应包括文档更新。
如需详细了解如何为 Bazel 做出贡献,请参阅我们的贡献指南。