scikit-learn / scikit-learn/scikit-learn

DOC Create triage guide in maintainer documentation

Open
#32,661 5 comments 3 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Documentation
Dominant language
Python
Stars
67.3k
Forks
27.4k
Avg merge
1d 15h
Merged PRs (30d)
58

Description

As part of talking about triaging at the Scientific Python Summit I realised that we have quite some cumulative experience with triaging. There are also different approaches to things.

As a result I think it would be useful if we create a triaging guide as part of our developer/maintainer documentation. The goal of the guide would be to serve as a reference for what to do as a triager, what tools we have available to help with the process and so on.

Some initial things I can think of including:

Can you think of more search queries that would be useful @lesteve?

xref https://github.com/scientific-python/summit-2025-nov/issues/6

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the existing developer/maintainer documentation, especially the bug_triaging.html#triaging-operations-for-members-of-the-core-and-contributor-experience-teams section, and review the linked GitHub search queries. The guide should cover triage labels, early-PR policy, useful searches, autoclose handling, and integration with the existing operations documentation.

Written by the indexing model from the issue text.

Assessment

Tech stack
github
Domain
developer-experience, documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.