Triaging and curating issues#

SciPy 有数百个未关闭的问题。关闭无效的问题,并正确标记有效的问题(最好在评论中添加一些初步想法),可以优先处理维护工作,并在处理现有函数或子包时轻松找到相关问题。

虽然任何人都可以评论并提供有关未关闭问题的更多信息,但如果要对 SciPy 仓库中的问题应用标签,则需要额外的权限。虽然没有正式流程来获得 triage 权限,但期望是,在加入团队之前,应该积极作为贡献者。

Roles and permissions#

SciPy 使用两级权限:triage 和核心团队成员。Triage 成员可以标记和关闭问题和 pull request,而 maintainers 可以标记和关闭问题和 pull request,并且还可以合并 pull request。

GitHub 发布了平台所有权限的完整列表。

Improving issues#

问题描述可能不完整、不准确或过时。无需特殊权限即可改进它们 - 这可能很有用,并有助于减轻维护者和其他贡献者的工作量。以下操作通常很有用

  • 记录缺少重现问题所需元素的问题,例如代码示例

  • 建议重新制定标题和描述,使其更明确地说明要解决的问题

  • 链接到相关问题或讨论,同时简要描述它们之间的关系,例如“请参阅 #xyz,了解对此的类似尝试”提供上下文并有助于讨论。

请记住,对问题或 pull request 的每次评论都会为一组人创建通知。请注意并根据需要使用编辑评论按钮。

Fruitful discussions#

在线讨论可能比最初想象的更困难,特别是考虑到对开源新手来说,对流程的理解可能与经验丰富的维护者截然不同。

总的来说,保持积极的态度并善意假设是有用的。这篇文章探讨了如何在开源环境中进行在线讨论。同样重要的是要记住,所有互动都应遵循 SciPy Code of Conduct

Issue labels (requires triage rights)#

创建问题或 pull request 时,SciPy 可能会根据标题或涉及的代码部分自动分配一个或多个标签。例如,所有标题包含 BUG: 前缀的问题都会自动收到 defect 标签。

在某些情况下,也可能需要手动包含其他标签。任何具有 triage 权限的人都可以根据需要添加或删除标签。请查看 当前标签的完整描述以获取更多信息。

Other references#