补丁接受流程

本页简要介绍了贡献者如何提议和更改 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 拉取请求会关闭。所有最终更改 都归因于您。