补丁接受流程

本页简要介绍了贡献者如何提出和更改 Bazel 代码库。

  1. 阅读 Bazel 贡献政策
  2. 创建 GitHub 问题, 讨论您的计划和设计。更改或添加行为的拉取请求需要有相应的问题来跟踪。
  3. 如果您要提出重大更改,请编写 设计文档
  4. 确保您已签署贡献者许可 协议
  5. 准备实现该功能的 Git 提交。别忘了添加测试并更新文档。如果您的更改具有用户可见的效果,请 添加版本说明。如果是存在不兼容的更改, 请阅读推出重大更改指南
  6. GitHub上创建拉取请求。如果您是 GitHub 新手, 请了解拉取 请求。请注意, 我们限制了在 Bazel 主代码库上创建分支的权限,因此 您需要将提交推送到 您自己的代码库分支
  7. Bazel 维护人员应在 7 个工作日内(不包括美国和德国的节假日)为您分配审核人员。如果您在该时间内未被分配审核人员,可以在拉取请求中提及 @bazelbuild/triage
  8. 与审核人员合作完成代码审核。对于每项更改,请创建一个新的提交并将其推送,以对拉取请求进行更改。如果审核时间过长(例如,审核人员无响应),您可以在拉取请求中提及 @bazelbuild/triage
  9. 审核完成后,Bazel 维护人员会将您的补丁应用于 Google 的内部版本控制系统。

    这会触发内部预提交检查,可能会建议进行更多更改。如果您未表达偏好,提交更改的维护人员可能会添加不影响设计的“琐碎”更改(例如linting)。如果需要进行更深入的更改,或者您希望直接应用更改,您和审核人员应在审核评论中清楚地说明偏好。

    内部提交后,补丁将导出为 Git 提交,此时 GitHub 拉取请求将关闭。所有最终更改都归您所有。