处理 Issue
我们的公共 issue 跟踪器 列出了我们计划做的所有事情以及来自社区的建议。在开始处理 issue 之前,请务必阅读此页面的其余部分。
Issue 标签
我们使用标签来指示 issue 的状态。有关标签最完整的文档可以在 维护 ESLint 文档 中找到,但大多数贡献者应该会发现此页面上的信息就足够了。作为贡献者,标签可以帮助您回答的最重要的问题是
-
这个 issue 我可以处理吗?如果您在贡献 ESLint 方面几乎没有或没有经验,
good first issue
标签标记了合适的 issue。否则,help wanted
标签是邀请您处理该 issue。如果您有更多经验,您可以尝试处理其他标记为accepted
的 issue。相反,尚未准备好处理的 issue 被标记为triage
、evaluating
和/或needs bikeshedding
,并且由于其他原因(例如依赖项中的 bug)目前无法处理的 issue 被标记为blocked
。 -
这个 issue 是关于什么的?描述 issue 性质的标签包括
bug
、enhancement
、feature
、question
、rule
、documentation
、core
、build
、cli
、infrastructure
、breaking
和chore
。这些在 维护 ESLint 中有文档记录。 -
这个 issue 的优先级是什么?因为我们有很多 issue,所以我们将某些 issue 的优先级置于其他 issue 之上。以下是优先级列表,从最高到最低
- Bug - 项目的问题正在积极影响用户。我们希望尽快解决这些问题。
- 文档 - 文档 issue 是一种 bug,因为它们正在积极影响当前用户。因此,我们希望尽快解决文档 issue。
- 功能 - 将来会帮助用户的新功能。
- 增强 - 对现有功能的请求改进。
- 其他 - 任何其他事情。
一些 issue 附带了金钱奖励。这些被标记为
bounty
。赏金通过 BountySource 分配。
开始工作
如果您要处理某个 issue,请在该 issue 上添加评论说明您要处理,并说明您认为何时完成它。这将帮助我们避免重复劳动。一些好的评论示例是
- “我将在周末看看这个。”
- “我将要做这个,给我两周时间。”
- “正在处理中”(意思是,我现在正在处理它)
如果一个 issue 已经被某人认领,请尊重该人完成工作的意愿,除非您确认他们不再感兴趣,否则请不要处理它。
如果您发现自己无法完成工作,那么只需添加评论让人们知道,例如
- “抱歉,看起来我没有时间做这个。”
- “我以为我了解足够多可以修复这个问题,但事实证明我没有。”
如果由于您无法完成 issue 而退出,没有人会责怪您。我们只是想尽可能高效地保持流程运转。