Clarify issue/PR choreography
Nobody has claimed this yet.
Assessment
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Newbie friendliness
- 52/100
- Issue type
- Documentation
- Clarity
- Mostly clear
- Activity status
- Active
- Domain
- documentation
Research direction
Start by locating the devguide’s opening instructions and the issue template, then review where DPO and triager guidance are introduced. Clarify that contributors should wait for triager validation before opening a PR, while noting the discussion around clear bugs. Done means the issue-to-PR workflow and exceptions are explicit to contributors.
Written by the indexing model from the issue text.
Description
From a discussion with @picnixz:
I think the problem with the devguide is the first sentence is "Create an issue that describes the change" and you'll see the mention to DPO only during creation. We can improve that
I would expect people to read the issue template correctly and understand that something is not trivial
and more importantly: WAIT for triagers to decide whether it's ok or not as an issue
There are obvious cases where the issue doesn't a triager for validation, like a clear bug (and even this is subject to interpretation sometimes) but the process issue+PR is the worst for triagers, especially when the PR is automated.
This might be a duplicate of other feedback here in issues, but I wanted to capture it before going back to $WORK.
- Dominant language
- Python
- Stars
- 2.1k
- Forks
- 1k
- Avg merge
- 2d 12h
- Merged PRs (30d)
- 12
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from python/devguide
-
type-feature
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
-
type-feature
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
-
topic-building python type-feature
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
-
needs: decision topic-test type-bug
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
topic-dev process type-feature
Difficulty 2/5 1-3 hours Newbie friendliness 62/100
Similar issues
-
sponsored
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 86/100
Diaoul/subliminal#1382 ·
-
Difficulty 1/5 Under an hour Newbie friendliness 92/100
-
triage/confirmed
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
agentscope-ai/agentscope#2775 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100