如何投稿

我们乐于接受您为此项目做出的补丁和贡献。只需遵循几个小准则即可。

贡献者许可协议

为任何 Google 项目做贡献都必须附带贡献者许可协议。这不是版权转让，只是授权 Google 在项目中使用和再分发您的贡献。

  • 如果您是个人编写原始源代码，并且确定自己拥有知识产权，则需要签署单独的 CLA。

  • 如果您供职的公司希望允许您贡献自己的工作成果，那么您需要签署公司 CLA。

您通常只需要提交一次 CLA，因此，如果您已经提交了一个 CLA（即使是用于其他项目），您可能就不需要再次提交。

提交补丁

  1. 通常，最好先打开一个新的问题，描述您打算修复的 bug 或功能。即使您认为这只是小事，了解人们在做什么也很有帮助。在最初的问题中提及您计划处理相应 bug 或功能，以便将其分配给您。

  2. 按照正常创建项目分支的流程操作，并设置要使用的新分支。请务必在单独的分支中进行每组更改，以确保拉取请求仅包含与该 bug 或功能相关的提交。

  3. 任何重大变更几乎都应该伴随着测试。该项目已有较好的测试覆盖率，因此，如果您不确定如何执行，请查看一些现有的测试。

  4. 尽可能为每项更改提供格式正确的提交消息。这可确保整个项目的一致性，并可确保提交消息能被各种 Git 工具设置为正确的格式。

  5. 最后，将提交推送到您的分支并提交拉取请求。