补丁接受流程

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

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

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

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