特殊标签
本指南面向维护者。 这些特殊成员拥有一个或多个 Jekyll 仓库的 写入权限,并负责帮助合并其他人的贡献。你可能会觉得这里的内容很有意思,但它并不适合所有人阅读。
我们在 GitHub.com 上使用了一系列“特殊标签”来自动处理 Pull Request 和 Issue 流程中的部分工作。
@jekyllbot 会根据用户或维护者的操作,自动添加或移除某些标签。 下面是这些标签及其工作方式:
pending-feedback
这个标签表示:我们需要 Issue 或 PR 作者提供更多信息后,才能继续处理。
例如:
- 你需要更多信息才能正确分类某个 Bug 报告
- 某个 PR 中还有未解决的问题,需要作者进一步回复
带有该标签的 Issue 可以暂时忽略,因为它当前正在等待反馈。
needs-work & pending-rebase
这两个标签用于表示:Pull Request 的 Git 状态需要发生变化。
当 PR 有新的 push(即触发 Pull Request 的 “synchronize” 事件)并重新变为可合并状态后,这两个标签都会被自动移除。
以下情况请添加 needs-work 标签:
- 代码审核后发现 PR 仍需要修改代码
以下情况请添加 pending-rebase 标签:
- 代码本身没问题
- 但当前分支无法自动与目标分支(例如
master)合并
stale
该标签会由 @jekyllbot 根据 Issue 或 Pull Request 的活跃情况自动添加和移除。
关于这个标签的具体规则,请查看: Triaging an Issue: Staleness and automatic closure
pinned
该标签用于让 @jekyllbot 忽略 Issue 的存活时间。
也就是说:
- 不会自动添加
stale标签 - 不会在一段时间后被自动关闭
这个标签需要手动设置,并且应谨慎使用。
(has-pull-request 标签也有类似效果,但不应该仅仅为了防止 Issue 被关闭而单独使用它)