title: "分类" post_status: publish comment_status: open taxonomy: category: - gutenberg-docs post_tag: - Contributors - Repos - Data


分类

为保持仓库健康,需要定期进行分类处理。分类是指审查现有议题和拉取请求,确保它们具有相关性、可操作性且包含所有必要信息。任何人都可以协助分类,但您需要成为 Gutenberg 仓库分类团队的成员才能修改议题标签或编辑其标题。

除了本页面,如何在 GitHub 上进行分类教程是另一个了解分类工作的绝佳资源

加入分类处理团队

分类处理团队是一个开放的群体,其特殊职责是确保在 Gutenberg 代码库中保持一致的分类处理流程。分类处理有多种形式:

成为分类处理团队成员有以下期望:

如果您想加入这个团队,随时可以在 #core-editor Slack 频道中提出申请。

处理你的首个议题

开始时,只需从以下筛选列表中选择一个。注意:你可以在总议题页面选择“排序”选项找到大部分这些筛选条件。

通用问题分类流程

在处理问题分类时,无论是针对上述列表还是一般问题,请逐一处理每个问题。以下是为每个问题可以执行的一些步骤:

  1. 首先搜索重复项。如果问题是重复的,请通过评论“重复于 #”来关闭它,并将任何相关的新细节添加到现有问题中。(别忘了也搜索已关闭问题中的重复项!)。
  2. 如果问题缺少标签,请添加一些以更好地分类(需要加入分类团队后获得的适当权限)。添加标签时,一个好的起点是应用一个以 [Type] 为前缀的标签(例如 [Type] Enhancement 或 [Type] Bug)来指示问题的类型。之后考虑添加更具描述性的标签。如果问题涉及特定的核心区块,请添加一个以 [Block] 为前缀的标签。或者,如果问题影响特定功能,则有 [Feature] 标签。最后,还有影响特定兴趣领域的标签,如 Accessibility 和 Internationalization。您可以在此处查看所有可能的标签。
  3. 如果标题未能清晰传达问题,请编辑它以使其更清晰(需要适当权限)。具体来说,我们建议将问题相关的主要功能放在标题的开头(示例),并且标题通常应尽可能简洁且具有描述性(示例)。
  4. 如果是错误报告,请测试以确认报告或添加 Needs Testing 标签。如果没有足够的信息来确认报告,请添加 [Status] Needs More Info 标签并询问所需的详细信息。当错误报告包含重现步骤时尤其有益,因此如果缺少这些步骤,请要求报告者添加。
  5. 当不再需要时,移除 [Status] Needs More Info 标签,例如,如果问题作者已回复足够的详细信息。
  6. 如果作者在 2 周以上未回复,请关闭不活跃的 [Status] Needs More Info 问题并附上说明
  7. 如果问题上有对话但未确定可操作的步骤,请跟进参与者以了解哪些是可操作的。在评论中回复时,请确保 @ 每个参与者。
  8. 如果您有信心进一步分类问题,那么您还可以:
    • 通过调试来检查错误报告是否有效,看看是否能追踪到技术细节。
    • 检查问题是否缺少某些细节,并尝试填补这些细节。例如,如果错误报告缺少视觉细节,在本地重现问题并上传截图或 GIF 会很有帮助。
    • 如果您认为这是一个相对简单的问题,适合首次贡献者尝试解决,请考虑添加 Good First Issue 标签。

常用标签

Generally speaking, the following labels are very useful for triaging issues and will likely be the ones you use the most consistently. You can view all possible labels here.

Label Reason
[Type] Bug When an intended feature is broken.
[Type] Enhancement When someone is suggesting an enhancement to a current feature.
[Type] Help Request When someone is asking for general help with setup/implementation.
Needs Technical Feedback When you see new features or API changes proposed.
Needs More Info When it’s not clear what the issue is or it would help to provide additional details.
Needs Testing When a new issue needs to be confirmed or old bugs seem like they are no longer relevant.

Determining priority labels

If you have enough knowledge about the report at hand and feel confident in doing so, you can consider adding priority. Note that it’s on purpose that no priority label infers a normal level.

Label Reason
Priority: High Fits one of the current focuses and is causing a major broken experience (including flow, visual bugs and blocks).
Priority: Low Enhancements that aren’t part of focuses, niche bugs, problems with old browsers.

关闭议题

议题因以下原因被关闭:

专项问题分类

发布专项分类

以下是在临近发布期间进行问题分类时需遵循的指南。与常规分类相比,这尤为重要,以便准确识别有问题的、阻碍发布的缺陷并找到解决方案。

专项设计分类

除了之前列出的通用分类流程外,针对参与分类的设计思维人员,还有一些针对设计中心的特定补充流程。

提醒事项:

有关每周设计分类的更多详细信息以及如何参与,请查阅此指南