rest25/bugs.rst => rest262/bugs.rst
n1-**************
n1+.. _reporting-bugs:
2-Reporting Bugs
3-**************
4
n5-.. _reporting-bugs:
n3+************************
4+Reporting Bugs in Python
5+************************
6
7Python is a mature programming language which has established a reputation for
8stability.  In order to maintain this reputation, the developers would like to
n9-know of any deficiencies you find in Python or its documentation.
n9+know of any deficiencies you find in Python.
10
n11-Before submitting a report, you will be required to log into SourceForge; this
12-will make it possible for the developers to contact you for additional
13-information if needed.  It is not possible to submit a bug report anonymously.
14- 
15-All bug reports should be submitted via the Python Bug Tracker on SourceForge
11+Bug reports should be submitted via the Python Bug Tracker
16-(`<http://sourceforge.net/bugs/?group_id=5470>`_).  The bug tracker offers a Web
12+(http://bugs.python.org/).  The bug tracker offers a Web form which allows
17-form which allows pertinent information to be entered and submitted to the
13+pertinent information to be entered and submitted to the developers.
18-developers.
19
20The first step in filing a report is to determine whether the problem has
21already been reported.  The advantage in doing so, aside from saving the
22developers time, is that you learn what has been done to fix it; it may be that
23the problem has already been fixed for the next release, or additional
24information is needed (in which case you are welcome to provide it if you can!).
n25-To do this, search the bug database using the search box on the left side of the
n20+To do this, search the bug database using the search box on the top of the page.
26-page.
27
28If the problem you're reporting is not already in the bug tracker, go back to
n29-the Python Bug Tracker (`<http://sourceforge.net/bugs/?group_id=5470>`_).
n23+the Python Bug Tracker.  If you don't already have a tracker account, select the
30-Select the "Submit a Bug" link at the top of the page to open the bug reporting
24+"Register" link in the sidebar and undergo the registration procedure.
31-form.
25+Otherwise, if you're not logged in, enter your credentials and select "Login".
26+It is not possible to submit a bug report anonymously.
32
n33-The submission form has a number of fields.  The only fields that are required
n28+Being now logged in, you can submit a bug.  Select the "Create New" link in the
34-are the "Summary" and "Details" fields.  For the summary, enter a *very* short
29+sidebar to open the bug reporting form.
30+ 
31+The submission form has a number of fields.  For the "Title" field, enter a
35-description of the problem; less than ten words is good.  In the Details field,
32+*very* short description of the problem; less than ten words is good.  In the
36-describe the problem in detail, including what you expected to happen and what
33+"Type" field, select the type of your problem; also select the "Component" and
37-did happen.  Be sure to include the version of Python you used, whether any
34+"Versions" to which the bug relates.
35+ 
36+In the "Comment" field, describe the problem in detail, including what you
37+expected to happen and what did happen.  Be sure to include whether any
38extension modules were involved, and what hardware and software platform you
39were using (including version information as appropriate).
n40- 
41-The only other field that you may want to set is the "Category" field, which
42-allows you to place the bug report into a broad category (such as
43-"Documentation" or "Library").
44
45Each bug report will be assigned to a developer who will determine what needs to
46be done to correct the problem.  You will receive an update each time action is
47taken on the bug.
48
49
50.. seealso::
51
n52-   `How to Report Bugs Effectively <http://www-mice.cs.ucl.ac.uk/multimedia/software/documentation/ReportingBugs.html>`_
n48+   `How to Report Bugs Effectively <http://www.chiark.greenend.org.uk/~sgtatham/bugs.html>`_
53      Article which goes into some detail about how to create a useful bug report.
54      This describes what kind of information is useful and why it is useful.
55
t56-   `Bug Writing Guidelines <http://www.mozilla.org/quality/bug-writing-guidelines.html>`_
t52+   `Bug Writing Guidelines <http://developer.mozilla.org/en/docs/Bug_writing_guidelines>`_
57      Information about writing a good bug report.  Some of this is specific to the
58      Mozilla project, but describes general good practices.
59
Legends
Colors
 Added 
Changed
Deleted
Links
(f)irst change
(n)ext change
(t)op