GitHub 标签

分类人员、核心开发者和机器人可以在 GitHub 上添加标签,以对问题和 Pull Request 进行分类。许多标签同时用于这两种用例,而有些标签仅用于其中一种。以下是可能不详尽的列表,但它应该可以帮助你入门。有关完整列表,请参见 此处

类型标签

这些标签用于指定问题的类型

组件标签

这些标签主要用于指定问题/PR 影响了代码库的哪个部分

操作系统标签

这些标签用于指定受影响的操作系统。由于大多数问题要么影响所有系统,要么特定于 Unix,因此我们没有专门的 Unix 标签。使用OS-windowsOS-macOS-freebsd

对于PEP 11中定义的支持层级之外的平台上的问题,请使用OS-unsupported标签。应用此标签会将问题添加到GitHub 项目中,以便对其进行进一步分类。另请参见平台专家列表

主题标签

这些标签用于表示问题/PR 的特定主题区域(如果有)。这包括特定模块/包和通用兴趣领域。

添加这些标签也是通知相关专家的方式,因为他们会订阅这些标签。根据标签,这还可能自动将问题添加到 GitHub 项目中。

您可以在 GitHub 上查看主题标签的完整列表

版本标签

这些标签用于指示受影响的 Python 版本。每当创建或取消新功能版本时,都会更新可用版本标签(形式为 3.N)。

另请参阅 分支状态页面,了解活动分支的列表。

其他标签

  • triaged:对于分类员接受为有效的 issue。

  • easy:对于被认为简单的 issue。

  • build/performance:分别用于与构建过程或性能相关的 issue。

  • release-blocker/deferred-blocker:对于除非修复,否则将分别保留当前或下一个版本的 issue/PR。分类员可能会为必须在发布之前修复的 issue 设置这些标签,而 分支的发布经理 将审查它们并确定它们是否确实合格,并根据需要删除或保留标签。

  • pending:对于除非提供进一步反馈,否则将关闭的 issue/PR。

  • stale:对于已经有一段时间不活跃的 issue/PR。

  • sprint:用于在官方 sprint 期间更容易地筛选正在处理的 issue/PR。

特定于 PR 的标签

以下标签仅适用于 Pull Request。它们要么由机器人自动设置,要么由人工添加以触发特定的机器人行为。

  • DO-NOT-MERGE:对于不应该在其当前状态下合并的 PR。它还阻止 miss-islington 自动合并 PR。

  • needs backport to X.Y:用于指示 PR 应回传到的分支。一旦合并 PR,miss-islington 将自动尝试为这些标签指示的版本创建回传 PR。另请参阅 Python 分支的状态,了解分支列表以及可以回传到这些分支的 PR 类型。

  • skip issue:对于不需要相应 issue 的微小更改(例如拼写错误修复、注释更改和部分重新表述)。

  • skip news:对于不需要 NEWS 条目的 PR。在 更新 NEWS 和 Python 中的新增内容 部分中详细介绍了在哪些情况下可以跳过 NEWS 条目。

  • test-with-buildbots:用于在合并前需要更多测试时,使用 buildbot 舰队 测试最新提交。这可能需要几个小时才能完成。

  • awaiting action:这些标签由 bedevere 应用和使用,以指示 PR 的阶段,不应手动应用。