标签是 GitHub 的一项实用功能,可用于过滤问题和拉取请求。它们可帮助您找到适合自己经验水平的有趣项目。
对于我们的代码库,向问题添加新标签完全由核心 Blockly 团队负责,以确保问题不会被错误地归类。
大小
有些问题小巧精美,而另一些问题可能需要数周时间才能解决。这些标签可帮助您了解问题可能需要多少工作量。
- Good first issue:这些问题非常适合刚接触该代码库的人员。这些任务应在半天内完成,并且只需对代码库有有限的了解。您可以立即开始处理这些问题,无需获得团队的批准。
管辖区
处理广泛使用的代码库可能是一个敏感的过程,并且有些问题可能比其他问题更敏感。这些标签可帮助您了解哪些问题可供贡献者参与,以及哪些问题应避免参与。
- 需要帮助:这些问题仅供贡献者处理。这些功能通常是核心团队认为有用但没有时间实现的功能。它们可能需要讨论或实现,因此请检查状态标签以了解需要完成哪些工作。您可以在这里找到有趣的广告素材项目!
- 内部:这些问题仅供核心团队成员查看。这些 bug 通常比较敏感或复杂,需要特别讨论。最好避开这些区域,因为周围的情况可能会迅速变化!
- 两者均无:没有这两个标签的问题可由贡献者和核心团队成员修复。如果您看到未标记的问题,但您对此问题感兴趣,请立即接手!
状态
某些问题(尤其是功能请求)在被视为“已关闭”之前,会经历几个不同的阶段。这些标签会告知您问题目前处于哪个阶段,以便您了解接下来需要做什么。
- 讨论:这些问题处于讨论阶段,这意味着在实施之前,仍有一些问题需要解答。如果您对此问题有任何想法,欢迎随时发表评论!我们一直期待收到更多意见。
- 实施:这些问题已得到充分讨论,并已明确定义,现在已进入实施阶段。这些功能要么正在等待实现,要么已经开始实现。如果您有兴趣处理其中一个问题,请通读整个问题,然后发表评论说明您想处理哪个部分,接着就可以开始着手处理了!
- 两者均无:既没有“已解决”标签也没有“已关闭”标签的问题可能处于任一状态。如果您对如何实现该问题有自己的看法,欢迎留言!或者,如果您有兴趣处理此问题,最好发表评论,询问是否可以实施。
类型
不同的问题需要不同的回答。有些只需要修改几行代码,而有些则需要大量的设计和讨论。这些标签会指明问题需要采取哪种类型的措施。
- Bug:这些问题记录了代码库存在的问题。这些问题通常需要进行一些调试才能诊断出问题的原因,但有些问题可以立即解决。如果您喜欢深入了解代码的运作方式,这些问题将非常适合您。您可以修复 bug,也可以深入了解问题并清楚说明根本原因,从而提供帮助。
- 功能请求:这些问题记录了用户希望添加的功能。这可以应用于整个代码库,也可以应用于单个项目。如果您喜欢完善设计构想和添加新功能,那么这些问题可能非常适合您。
- 问题: 这些问题记录了某人对代码库提出的疑问。一般来说,这些问题会被重定向到开发者论坛,但如果您看到自己可以解答的问题,欢迎随时参与并回答。
类别
此代码库包含几种不同类型的项目,面向几种不同的目标受众群体。如果您对教程充满热情,或者喜欢使用插件,这些标签可以帮助您找到感兴趣的问题。
- Codelab:这些问题与 Blockly Codelab(一套交互式教程)有关。
- 示例: 这些问题与 Blockly 示例(一组展示如何包含和扩展 Blockly 的独立演示)有关。
- 插件:这些问题与 Blockly 插件(一组可为 Blockly 添加功能的扩展程序)有关。
项目
如果您想获得更精细的控制,还可以使用各个项目的标记。这些问题通常是为插件创建的,插件往往存在更多相关问题,但也可以为 Codelab 和示例创建问题。如果您对某个特定项目感兴趣,这些标签可以帮助您找到与该项目相关的问题。
如需查看您感兴趣的项目是否有标签,请参阅标签的完整列表:
其他
与任何事物集合一样,您还应了解一些特殊情况。当您寻找要处理的问题时,这些标签可能不太有用,但仍可提供一些信息。
- 需要分诊:这些问题尚未得到核心团队的正确标记。带有此标签的问题可能已经包含其他简单标签,例如 bug 或 feature request,但很快可能会添加更多标签。
- 重复:这些问题记录的问题、请求或疑问已在其他问题中涵盖。此标签表示您不应回复此问题,而应回复原始问题。