本页简要介绍了贡献者如何提出和更改 Bazel 代码库。
- 阅读 Bazel 贡献政策。
- 创建 GitHub 问题, 讨论您的计划和设计。更改或添加行为的拉取请求需要有相应的问题来跟踪。
- 如果您要提出重大更改,请编写 设计文档。
- 确保您已签署贡献者许可 协议。
- 准备实现该功能的 Git 提交。别忘了添加测试并更新文档。如果您的更改具有用户可见的效果,请 添加版本说明。如果是存在不兼容的更改, 请阅读推出重大更改指南。
- 在 GitHub上创建拉取请求。如果您是 GitHub 新手, 请了解拉取 请求。请注意, 我们限制了在 Bazel 主代码库上创建分支的权限,因此 您需要将提交推送到 您自己的代码库分支。
- Bazel 维护人员应在 7 个工作日内(不包括美国和德国的节假日)为您分配审核人员。如果您在该时间内未被分配审核人员,可以在拉取请求中提及
@bazelbuild/triage。 - 与审核人员合作完成代码审核。对于每项更改,请创建一个新的提交并将其推送,以对拉取请求进行更改。如果审核时间过长(例如,审核人员无响应),您可以在拉取请求中提及
@bazelbuild/triage。 审核完成后,Bazel 维护人员会将您的补丁应用于 Google 的内部版本控制系统。
这会触发内部预提交检查,可能会建议进行更多更改。如果您未表达偏好,提交更改的维护人员可能会添加不影响设计的“琐碎”更改(例如linting)。如果需要进行更深入的更改,或者您希望直接应用更改,您和审核人员应在审核评论中清楚地说明偏好。
内部提交后,补丁将导出为 Git 提交,此时 GitHub 拉取请求将关闭。所有最终更改都归您所有。