本页概述了贡献者如何提交 Bazel 代码库的更改建议以及如何进行更改。
- 阅读 Bazel 贡献政策。
- 创建 GitHub 问题来讨论您的计划和设计。更改或添加行为的拉取请求需要相应的问题进行跟踪。
- 如果您要提出重大更改，请编写设计文档。
- 确保您已签署贡献者许可协议。
- 准备用于实现该功能的 Git 提交。别忘了添加测试并更新文档。如果您的更改会对用户产生可见影响，请添加版本说明。如果是不可兼容的更改，请参阅有关发布破坏性更改的指南。
- 在 GitHub 上创建拉取请求。如果您刚接触 GitHub，请阅读关于拉取请求。请注意，我们限制了在主要 Bazel 代码库中创建分支的权限，因此您需要将提交内容推送到您自己的代码库分支。
- Bazel 维护者应该会在 2 个工作日内（不包括美国和德国的节假日）为您分配审核员。如果您在此期间未被分配审核员，可以发送电子邮件至 bazel-discuss@googlegroups.com 申请审核员。
- 与审核者合作完成代码审核。对于每项更改，请创建一个新的提交并将其推送，以便更改拉取请求。如果审核时间过长（例如，审核员未回复），请发送电子邮件至 bazel-discuss@googlegroups.com。
审核完成后，Bazel 维护人员会将您的补丁应用到 Google 的内部版本控制系统。
这会触发内部提交前检查，系统可能会建议您进行更多更改。如果您未表达自己的偏好，提交您更改的维护者会添加不会影响设计的“琐碎”更改（例如linting）。如果需要更深入的更改，或者您希望直接应用更改，您和审核者应在审核评论中明确说明自己的偏好。
在内部提交后，补丁会作为 Git 提交内容导出，此时 GitHub 拉取请求会关闭。所有最终更改都将归因于您。