翻译:人工 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 系统进行重大修改。
- 文档。在适用情况下,功能贡献应包含文档更新。
如需详细了解如何为 Bazel 做贡献,请参阅我们的贡献准则。