问题标签

标签是 GitHub 的一项出色功能,可用于过滤问题和拉取请求。能帮助您找到适合自己经验水平的有趣工作。

对于我们的代码库,为问题添加新标签由 Blockly 核心团队独家处理,以确保不会出现在错误的位置。

大小

有些问题是轻而易举的,而有些问题可能需要数周时间才能解决。这些标签可帮助您了解某个问题可能需要多少工作量。

  • 好的优先问题:这些问题非常适合刚开始接触代码库的用户。只需不到半天的工作量,并且对代码库的熟悉程度会非常有限。您可以立即开始解决这些问题,而无需获得团队批准。

管辖区

处理广泛使用的代码库可能是一个敏感过程,其中一些问题可能比其他问题更敏感。这些标签可帮助您确定哪些问题可进一步贡献,以及哪些问题需要注意。

  • 希望获取帮助:这些问题由贡献者保留。核心团队认为这些功能通常很有用,但却没有时间实现这些功能。它们可能需要展开讨论或实现,因此请查看状态标签,了解需要采取哪些工作。这里是寻找趣味创意项目的好地方!
  • 内部:这些问题仅面向核心团队成员提供。它们通常是需要特别讨论的敏感或复杂 bug。最好避免这些情况,因为它们周围的情况可能会快速变化!
  • 两个都不能: 没有该标签的问题可由贡献者核心团队成员解决。如果您发现某个似乎感兴趣的未加标签问题,请直接解决!

状态

某些问题(尤其是功能请求)需要经历几个不同的阶段,然后才能被视为“已关闭”。这些标签会告知您问题当前所处的阶段,以便您了解接下来需要执行什么操作。

  • 讨论:这些问题处于讨论阶段,也就是说,在实现之前仍有一些问题需要回答。如果您对此问题有任何想法,请随时发表评论!我们一直在寻求更多意见。
  • 实现:这些问题已经过充分讨论并且明确定义了问题,并且已进入实现阶段。它们可能正在等待实施或已实施。如果您有兴趣处理其中某个问题,请通读全文,然后发表评论,说明您要处理哪个部分,然后继续深入了解相关内容!
  • 两者都不是:没有标签的问题可能会处于任一状态。如果您对应如何实施此问题有任何看法,请发表评论!或者,如果您有兴趣处理该问题,最好发表评论,询问它是否已准备好实现。

类型

不同的问题需要不同的回复。有些只需要修改几行代码,而有些则需要大量的设计和讨论。这些标签会告诉您某个问题需要采取什么类型的操作。

  • bug:这些问题记录了代码库的问题。它们通常需要进行一些调试才能诊断导致问题的原因,但有些问题可以瞬间修复。如果您喜欢深入研究代码的运行方式,那么这些问题将对您来说非常重要。您可以通过修复 bug 或深入了解问题并编写清晰的根本原因解释来提供帮助。
  • 功能请求:这些问题记录了用户希望添加的功能。它可以适用于整个代码库,也可以适用于单个项目。如果您想充实设计理念和添加新功能,这些可能是最适合您的问题。
  • 问题:这些问题记录了用户针对代码库存有疑问。这些问题通常会被重定向到开发者论坛,但如果您看到自己认为自己可以帮忙的问题,请随时加入并回复。

Category

此代码库包含几种不同类型的项目,以及几种不同类型的目标对象群组。如果您热衷于教程,或者喜欢处理插件,这些标签可以帮助您找到感兴趣的问题。

  • Codelab:这些问题与 Blockly Codelab 相关,这是一套交互式教程。
  • 示例:这些问题与 Blockly 示例有关,这是一组独立的演示,用于展示如何添加和扩展 Blockly。
  • 插件:这些问题与 Blockly 插件相关,这是一系列可添加 Blockly 功能的扩展程序。

项目

如果您想更精细地查看各个项目的标记,还可使用相应的标记。这类测试通常是为插件创建的,因为插件往往会存在更多相关问题,但也可以针对 Codelab 和示例创建。如果您对特定项目感兴趣,这些标签可以帮助您查找与该项目相关的问题。

另请注意,我们会经常添加新项目,因此此列表可能会过时! 如果您没有看到您感兴趣的项目对应的条目,请查看完整的标签列表

  • 开发者工具:这些问题与开发者工具软件包相关,后者是一个适用于 Blockly 扩展程序开发的常用实用程序库。
  • 字段日期:这些问题与日期字段软件包相关,后者是一个使用 Google 闭包日期选择器的日期选择器字段。

其他

与任何收藏的事物一样,您也应该了解一些奇怪的球。当您查找要解决的问题时,这些标签可能没那么有用,但仍然具有参考价值。

  • 分类:核心团队尚未对这些问题进行适当标记。具有此标签的问题可能已包含另一个简单的标签,如 bug功能请求,但可能很快就会添加更多标签。
  • 重复:这些问题会记录已由其他问题涵盖的问题、请求或疑问。此标签表示您不应回复此问题,而应回复原始问题。