如何投稿

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

贡献者许可协议

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

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

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

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

提交补丁

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

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

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

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

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