补丁接受流程

报告问题 查看源代码 每夜版 · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

本页面概述了贡献者如何提议并更改 Bazel 代码库。

  1. 阅读 Bazel 贡献政策
  2. 创建 GitHub 问题来讨论您的计划和设计。更改或添加行为的 pull 请求需要有相应的跟踪问题。
  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 拉取请求会关闭。所有最终更改都归因于您。