2000-09-25 12:08:03 -04:00
|
|
|
PEP: 3
|
2008-05-20 08:19:17 -04:00
|
|
|
Title: Guidelines for Handling Bug Reports
|
2022-10-05 12:48:43 -04:00
|
|
|
Author: Jeremy Hylton <jeremy@alum.mit.edu>
|
2010-02-21 21:49:10 -05:00
|
|
|
Status: Withdrawn
|
2007-06-19 00:52:34 -04:00
|
|
|
Type: Process
|
2000-09-25 12:08:03 -04:00
|
|
|
Created: 25-Sep-2000
|
2008-05-20 08:19:17 -04:00
|
|
|
Post-History:
|
2000-09-25 12:08:03 -04:00
|
|
|
|
2024-04-14 09:35:25 -04:00
|
|
|
.. withdrawn::
|
2024-04-14 16:08:31 -04:00
|
|
|
|
2024-04-14 09:35:25 -04:00
|
|
|
This PEP contained guidelines for handling bug reports in the Python
|
|
|
|
bug tracker. It has been replaced by the
|
|
|
|
`Developer's Guide description of issue triaging
|
|
|
|
<https://devguide.python.org/triage/triaging/index.html>`_.
|
|
|
|
Guidelines for people submitting Python bugs are `in the Python docs
|
|
|
|
<http://docs.python.org/bugs.html>`__.
|
2010-02-23 19:58:25 -05:00
|
|
|
|
|
|
|
Original Guidelines
|
2016-06-19 15:32:58 -04:00
|
|
|
===================
|
|
|
|
|
|
|
|
1. Make sure the bug category and bug group are correct. If they are
|
|
|
|
correct, it is easier for someone interested in helping to find
|
|
|
|
out, say, what all the open Tkinter bugs are.
|
2010-02-23 19:58:25 -05:00
|
|
|
|
2016-06-19 15:32:58 -04:00
|
|
|
2. If it's a minor feature request that you don't plan to address
|
2022-01-21 06:03:51 -05:00
|
|
|
right away, add it to :pep:`42` or ask the owner to add it for you.
|
|
|
|
If you add the bug to :pep:`42`, mark the bug as "feature request",
|
2016-06-19 15:32:58 -04:00
|
|
|
"later", and "closed"; and add a comment to the bug saying that
|
|
|
|
this is the case (mentioning the PEP explicitly).
|
2010-02-23 19:58:25 -05:00
|
|
|
|
2016-06-19 15:32:58 -04:00
|
|
|
::
|
2010-02-23 19:58:25 -05:00
|
|
|
|
2016-06-19 15:32:58 -04:00
|
|
|
XXX do we prefer the tracker or PEP 42?
|
2010-02-23 19:58:25 -05:00
|
|
|
|
2016-06-19 15:32:58 -04:00
|
|
|
3. Assign the bug a reasonable priority. We don't yet have a clear
|
|
|
|
sense of what each priority should mean. One rule, however, is
|
|
|
|
that bugs with priority "urgent" or higher must be fixed before
|
|
|
|
the next release.
|
2010-02-23 19:58:25 -05:00
|
|
|
|
2016-06-19 15:32:58 -04:00
|
|
|
4. If a bug report doesn't have enough information to allow you to
|
|
|
|
reproduce or diagnose it, ask the original submitter for more
|
|
|
|
information. If the original report is really thin and your email
|
|
|
|
doesn't get a response after a reasonable waiting period, you can
|
|
|
|
close the bug.
|
2010-02-23 19:58:25 -05:00
|
|
|
|
2016-06-19 15:32:58 -04:00
|
|
|
5. If you fix a bug, mark the status as "Fixed" and close it. In the
|
|
|
|
comments, include the SVN revision numbers of the commit(s). In
|
|
|
|
the SVN checkin message, include the issue number **and** a
|
|
|
|
normal description of the change, mentioning the contributor if a
|
|
|
|
patch was applied.
|
2010-02-23 19:58:25 -05:00
|
|
|
|
2016-06-19 15:32:58 -04:00
|
|
|
6. If you are assigned a bug that you are unable to deal with, assign
|
|
|
|
it to someone else if you think they will be able to deal with it,
|
|
|
|
otherwise it's probably best to unassign it.
|
2010-02-23 19:58:25 -05:00
|
|
|
|
|
|
|
|
|
|
|
References
|
2016-06-19 15:32:58 -04:00
|
|
|
==========
|
2010-02-23 19:58:25 -05:00
|
|
|
|
2022-10-05 12:48:43 -04:00
|
|
|
* https://bugs.python.org
|