维护 Karma

本文档适用于 Karma 的开发人员。它描述了常见的任务，例如分类或合并拉取请求。

如果您有兴趣为 Karma 做贡献，可以查看 为 Karma 贡献代码。

我们使用 gitter/karma-runner 来讨论拉取请求和问题，例如，“嘿，这件事很重要，你能看看吗……”，“我不确定如何解决这个问题……”。

分类问题 #

每天都会出现新的问题。我们需要识别紧急问题（例如“没有人可以安装 karma”），关闭重复问题，回答问题等等。

有关更多信息，请参阅 angular/TRIAGING.md。

当某个问题或拉取请求未分配给任何里程碑时，它就是未分类的（需要分类）。

合并拉取请求 #

请确保

• CI 构建成功。
• 至少有一位所有者（除您以外）批准了 PR
  • 通过评论“LGTM”或类似内容。
  • 如果只是简单的文档更改或拼写错误修复，可以跳过此步骤。
• 所有提交都遵循 约定。
  • 这非常重要，因为自动发布任务依赖于它。
  • 提交已压缩。每次更改都是一个单独的提交。
    • 例如，如果 PR 包含两个更改，例如，fix(web-server): xxx 然后 style(web-server): missing semicolons；它应该是两个单独的更改
    • 例如，如果第一次提交是 fix(web-server): serve binary files 并且第二次提交是“修复上一次提交中中断的单元测试”，则应将它们压缩成一个提交。
  • 可以要求拉取请求的作者修复上述任何问题。

发布 npm #

适用于具有管理员权限的核心协作者。

• 使用稳定的网络，以免在发布过程中断开连接。
• 确保您已同步到上游 master 分支。
• echo $GH_TOKEN
  • 如果未设置，请从 https://github.com/settings/tokens/new 设置 GH_TOKEN
• npm login karmarunnerbot
  • 密码由授权发布者知晓。
• grunt release 如果发布失败，请检查推送到 GitHub 的 git 标签状态。您可能需要删除其中一个。

所有权 #

每个项目都有一个或多个所有者（或“维护者”），列在 package.json 的 owners 字段中。通常，所有者具有推送权限。

成为某个插件的维护者并不意味着您不能为其他插件做贡献。事实上，您可以成为多个项目的维护者。主要目的是要有熟悉代码库的人，因此他们可以更好地决定什么是好的更改或不好的更改。

成为维护者 #

如果您有兴趣成为 Karma 维护者，请先开始分类问题，审查拉取请求，并在 gitter/karma-runner 上与我们交流。一旦我们看到您正在提供帮助，我们将授予您推送权限。成为维护者没有义务。您可以在有时间的时候提供帮助，在没有时间的时候减少参与。如果您找到新工作并变得忙碌，这没关系。

以上所有内容仅供参考，是我们发现对提高效率有帮助的一些方法。没有任何内容是固定的。如果您认为有方法可以改进此工作流程，请发送提案至 [email protected]。