Reporting Bugs
**************

Python 是一门成熟的编程语言，以稳定著称。为了维持这种声誉，开发者想知
道您在 Python 中找到的所有缺陷。


文档错误
========

如果您在本文档中发现了错误并打算帮助我们改进，请将错误提交到 tracker。
如果您有相应的修正建议，请一并提交。

如果您时间有限，还可以通过电子邮件将文档的错误报告发送至
docs@python.org （代码运行错误请发送至 python-list@python.org）。
“docs@”是一个由志愿者运作的邮件列表；您的请求会得到关注，但可能需要一
些时间才会被处理。

参见: 在 Python 的错误追踪系统上的 Documentation bugs


使用 Python 的错误追踪系统
==========================

对于 Python 本身的错误报告应当通过 Python 错误追踪系统（
https://bugs.python.org/）进行提交。该错误追踪系统提供了一个可以输入并
提交相关信息给开发者的网页表单。

填写报告的第一步是确认是否有重复的报告。这样做除了可以节省开发者的时间
，也能让您从中为了解决这个问题我们做出了怎样的努力；我们有可能我们已经
在下个版本中修复了这个问题，也有可能需要更详细的信息来搞定它（在这种情
况下，如果可以，非常欢迎您提供这些信息！）。要查找重复的报告，请使用错
误数据库页面顶部的搜索栏进行搜索。

如果您正在报告的问题并没有记录在错误追踪系统中，请返回并登录 Python 错
误追踪系统。如果您没有一个错误追踪系统的账号，请选择“注册（Register）”
链接，或者如果您想使用 OpenID 的话，请选择侧边栏中任何一个 OpenID 提供
方的标识。您不能匿名提交一份错误报告。

如果已经登录， 那您就可以提交错误报告了。请点击侧边栏中的“新建（Create
New）”链接，打开错误报告表单。

The submission form has a number of fields.  For the “Title” field,
enter a *very* short description of the problem; less than ten words
is good.  In the “Type” field, select the type of your problem; also
select the “Component” and “Versions” to which the bug relates.

在”说明“栏，请详细描述问题，包括您预期的情况和实际的情况。请确保信息包
含任何涉及的拓展模块，以及您当时所使用的硬件和软件平台(如果可能，请附
上版本信息)。

每一份错误报告将被分派给一名开发者，并由这名开发者决定如何更正这个问题
。每当有针对该错误的进展时，您都会收到一个更新通知。

参见:

  How to Report Bugs Effectively
     文章详细介绍了如何创建一份有用的错误报告。它描述了什么样的信息是
     有用的以及为什么是有用的。

  错误书写导引
     有关书写一份好的错误报告的信息。部分仅针对 Mozilla 项目，不过其描
     述了通用的恰当做法。


开始为 Python 贡献您的知识
==========================

除了仅仅报告您所发现的错误之外，同样欢迎您提交修复它们的补丁。您可以在
Python 开发者指引 中找到更多上手为 Python 打补丁的相关信息。如果您有任
何问题，核心导师邮件列表 是一个友好的去处，在那里， 你可以寻求修复
Python事宜相关问题的答案。
