GitHub 标签¶
分类人员、核心开发者和机器人可以在 GitHub 上添加标签,以对问题和 Pull Request 进行分类。许多标签同时用于这两种用例,而有些标签仅用于其中一种。以下是可能不详尽的列表,但它应该可以帮助你入门。有关完整列表,请参见 此处。
类型标签¶
这些标签用于指定问题的类型
type-bug
:用于意外行为、错误或异常(非严重崩溃)。type-crash
:用于解释器的严重崩溃,可能伴随核心转储。type-feature
:用于功能请求或增强。功能请求不需要版本标签;隐含地将功能仅添加到main
分支。可以在Ideas Discourse 类别中讨论增强功能,然后再提交问题。type-security
:用于安全问题。另请参见报告 Python 中的安全问题。
组件标签¶
这些标签主要用于指定问题/PR 影响了代码库的哪个部分
操作系统标签¶
这些标签用于指定受影响的操作系统。由于大多数问题要么影响所有系统,要么特定于 Unix,因此我们没有专门的 Unix 标签。使用OS-windows
、OS-mac
和OS-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 的阶段,不应手动应用。