解决 Bug
********

Python 是一门以稳定著称的编程语言。为了保持它的稳定性，开发者们想了解
您在 Python 中发现的任何缺陷。

有时候自己修复漏洞并将补丁提交给 Python 能更快地解决问题，因为它简化了
流程并且减少了参与的人力。 请参阅如何 提交补丁。


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

如果您在本文档中发现了错误并打算帮助我们改进，请将错误提交到 追踪系统
。 如果您有相应的修正建议，请一并提交。 （译者注：如果是中文文档翻译相
关的错误，请务必提交到 https://github.com/python/python-docs-zh-
cn/issues。如果将翻译问题反馈到了其他地方，可能会因为语言不通而不能及
时处理。）

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

参见:

  Documentation bugs
     已提交给 Python 问题追踪系统的文档错误列表。

  问题跟踪
     在追踪系统上参与问题改进的过程概述。

  改进文档
     给有兴趣为 Python 文档做出贡献的人。

  文档翻译
     文档翻译的 GitHub 页面及其主要联系人的列表


使用 Python 的问题追踪系统
==========================

Issue reports for Python itself should be submitted via the GitHub
issues tracker (https://github.com/python/cpython/issues). The GitHub
issues tracker offers a web form which allows pertinent information to
be entered and submitted to the developers.

The first step in filing a report is to determine whether the problem
has already been reported.  The advantage in doing so, aside from
saving the developers' time, is that you learn what has been done to
fix it; it may be that the problem has already been fixed for the next
release, or additional information is needed (in which case you are
welcome to provide it if you can!). To do this, search the tracker
using the search box at the top of the page.

If the problem you're reporting is not already in the list, log in to
GitHub. If you don't already have a GitHub account, create a new
account using the "Sign up" link. It is not possible to submit a bug
report anonymously.

Being now logged in, you can submit an issue. Click on the "New issue"
button in the top bar to report a new issue.

The submission form has two fields, "Title" and "Comment".

For the "Title" field, enter a *very* short description of the
problem; less than ten words is good.

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

Each issue report will be reviewed by a developer who will determine
what needs to be done to correct the problem. You will receive an
update each time an action is taken on the issue.

参见:

  如何有效地报告错误
     该文章详细介绍了如何创建一份有用的错误报告。它描述了什么样的信息
     是有用的，以及为什么是有用的。

  Bug Writing Guidelines
     关于写一份好的错误报告。部分仅针对 Mozilla 项目，不过其描述了通用
     的恰当做法。


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

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