相约 2023 年 BazelCon 将于 10 月 24 日至 25 日在 Google 慕尼黑举办!了解详情

补丁程序接受流程

报告问题 查看源代码

本页面概述了贡献者如何建议和更改 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 的内部版本控制系统。

    这会触发内部提交前检查,这可能建议进行更多更改。如果您尚未表示偏好,提交更改的维护者会添加对设计没有影响的“细微”更改(如 lint)。如果需要进行更深入的更改,或者希望直接应用更改,您和审核者应在审核评论中明确传达偏好设置。

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