Skip to content

Commit bd096c0

Browse files
DOC: Update Issue Triage Instructions
- Encouraged partial contributions to triaging process at the start of the section. - Removed the 'No Action' milestone. - Specified when to remove the 'Needs Triage' tag. - Explained the need for 'Needs Discussion' tag on feature requests. - Removed Contributions Welcome milestone. Closes pandas-dev#55311
1 parent 7e68183 commit bd096c0

File tree

1 file changed

+12
-9
lines changed

1 file changed

+12
-9
lines changed

doc/source/development/maintaining.rst

+12-9
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,9 @@ reading.
4444
Issue triage
4545
------------
4646

47+
Triage is an important first step in addressing issues reported by the community, and even
48+
partial contributions are a great way to help maintain pandas. Only remove the "Needs Triage"
49+
tag once all of the steps below have been completed.
4750

4851
Here's a typical workflow for triaging a newly opened issue.
4952

@@ -67,9 +70,9 @@ Here's a typical workflow for triaging a newly opened issue.
6770
3. **Is this a duplicate issue?**
6871

6972
We have many open issues. If a new issue is clearly a duplicate, label the
70-
new issue as "Duplicate" assign the milestone "No Action", and close the issue
71-
with a link to the original issue. Make sure to still thank the reporter, and
72-
encourage them to chime in on the original issue, and perhaps try to fix it.
73+
new issue as "Duplicate" and close the issue with a link to the original issue.
74+
Make sure to still thank the reporter, and encourage them to chime in on the
75+
original issue, and perhaps try to fix it.
7376

7477
If the new issue provides relevant information, such as a better or slightly
7578
different example, add it to the original issue as a comment or an edit to
@@ -90,15 +93,19 @@ Here's a typical workflow for triaging a newly opened issue.
9093
If a reproducible example is provided, but you see a simplification,
9194
edit the original post with your simpler reproducible example.
9295

96+
Ensure the issue exists on the main branch and that it has the "Needs Triage" tag
97+
until all steps have been completed.
98+
9399
5. **Is this a clearly defined feature request?**
94100

95101
Generally, pandas prefers to discuss and design new features in issues, before
96102
a pull request is made. Encourage the submitter to include a proposed API
97103
for the new feature. Having them write a full docstring is a good way to
98104
pin down specifics.
99105

100-
We'll need a discussion from several pandas maintainers before deciding whether
101-
the proposal is in scope for pandas.
106+
Tag new feature requests with "Needs Discussion", as we'll need a discussion
107+
from several pandas maintainers before deciding whether the proposal is in
108+
scope for pandas.
102109

103110
6. **Is this a usage question?**
104111

@@ -117,10 +124,6 @@ Here's a typical workflow for triaging a newly opened issue.
117124
If the issue is clearly defined and the fix seems relatively straightforward,
118125
label the issue as "Good first issue".
119126

120-
Typically, new issues will be assigned the "Contributions welcome" milestone,
121-
unless it's know that this issue should be addressed in a specific release (say
122-
because it's a large regression).
123-
124127
Once you have completed the above, make sure to remove the "needs triage" label.
125128

126129
.. _maintaining.regressions:

0 commit comments

Comments
 (0)