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