分诊团队

Python 分诊团队是一个致力于通过对开放问题和拉取请求进行周密的审查和分诊来提高工作流效率的团队。这有助于贡献者及时收到反馈,并使核心开发者能够专注于已审查的项目,从而减轻他们的工作量。此角色的期望扩展了 问题跟踪器 上的“分诊员”角色。下面列出的职责主要集中在 Python GitHub 存储库周围。这不仅限于 CPython,而且根据需要扩展到其他存储库,例如 devguide 和 core-workflow。

职责包括

  • 对问题和 PR 进行分类

  • 向问题/PR 应用适当的 标签

  • 通知适当的核心开发者

  • 审查 PR

  • 协助贡献者

虽然分诊员有权关闭 PR,但他们通常不应在不首先咨询核心开发者的情况下这样做。通过让分诊员和核心开发者共同努力,作者会收到对他们的 PR 的仔细考虑。这会鼓励未来的贡献,无论他们的 PR 是被接受还是关闭。

尽管如此,如果分诊员判断 PR 合并的机会极低,即使对 PR 进行了实质性修改,他们也应该随时关闭 PR。这包括(但不限于)以下内容

  • 仅提出外观更改的 PR

  • 提出对已弃用模块进行更改的 PR

  • 不再相关的 PR。这包括

    • 提出对不再能够重现的错误进行修复的 PR

    • 提出已被 Python 核心开发者在其他地方拒绝的更改的 PR(例如在问题或 PEP 拒绝通知中)

如果分诊员对是否关闭 PR 有任何疑问,他们应在采取任何行动之前咨询核心开发者。

分诊员还可以利用 pendingstale 标签来建议 PR 可能适合关闭。有关更多信息,请参阅 其他标签 部分中的条目。

请注意,善待和尊重 Python 项目的每位贡献者至关重要。无论他们是完全的新手还是资深核心开发者,他们都积极选择自愿捐出时间来改进 Python。与 Python 软件基金会的任何成员一样,始终遵循 PSF 行为准则

成为 Python 分诊团队的成员

欢迎所有 Python 核心开发者邀请 Python 贡献者加入 Python 分诊团队。分诊员将负责处理问题,还包括拉取请求,甚至管理反向移植。Python 分诊员可以访问的存储库不仅仅是 CPython。

当你持续展示在没有指导的情况下正确帮助分诊问题的能力时,你可以要求在 问题跟踪器 上授予你“分诊员”角色。你可以向任何核心开发者提出请求。如果他们决定你已准备好获得跟踪器上的额外权限,他们将作为你的导师,直到你准备好完全独立地做事。对于在之前你帮助处理了多少问题或你参与了多长时间,没有既定的规则。关键要求是你表现出帮助的意愿,你能够与他人(尤其是已经拥有分诊员角色的人)很好地合作,并且牢固掌握如何在问题跟踪器上正确地自己做事。

获得分诊员角色将允许你在跟踪器中的任何问题上设置任何值,从而减轻你必须要求其他人为你设置问题上的值以便正确分诊某些内容的负担。这不仅有助于加快和简化你在帮助中的工作,还有助于通过获得你的帮助来减轻每个人的工作量。

GitHub 上 Python 存储库的任何现有活跃贡献者都可以转变为 Python 分诊员。他们可以通过 Discourse 中的 DM 向任何核心开发者提出此请求,或通过在 core-workflow 存储库中打开 问题 公开提出此请求。如果核心开发者决定你已准备好获得跟踪器上的额外权限,他们将要求 Python 组织管理员 邀请你加入 Python 组织,然后作为你的导师,直到你准备好完全独立地做事。

对于每位新分检员,在 Python Discourse 上的 提交者类别 中宣布他们将是一件很棒的事情(示例公告)。