处理 Bug
********

Python 是一门成熟的编程语言，以稳定著称。为维持其美誉，开发者希望获悉
所有您在 Python 中发现的缺陷。

有时候自己修复程序缺陷并向 Python 提交补丁能更快地解决问题因为它简化了
处理流程并减少了人力消耗。 了解如何 提交补丁。


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

如果您在本文档中发现错误或想要提出改进建议，请在 问题追踪器 上提交错误
报告。如果您有修复建议，也请一并提供。

如果程序缺陷或建议的改进涉及此文档的翻译，请提交报告至 translation’s
repository。

你还可以在我们的 文档论坛 上发起一个讨论。

如果你在文档的主题（HTML / CSS / JavaScript）中发现错误，请在 python-
doc-theme 问题追踪器 上提交错误报告。

参见:

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

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

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

  Documentation Translations
     A list of GitHub pages for documentation translation and their
     primary contacts.


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

针对 Python 本身的问题报告应当通过 GitHub 问题追踪系统
(https://github.com/python/cpython/issues) 来提交。GitHub 问题追踪系统
提供了一个网页表单用来输入并提交相关信息给开发者。

第一步是确定问题是否已经被报告了。 这样做的好处除了可以节省开发者的时
间，还可以让你了解该问题是如何解决的；有可能该问题已在下一发布版中被修
复，或者还需要额外的信息（在此情况下非常欢迎你来提供信息！）。 要确定
这一点，请使用页面顶部的搜索框来搜索问题追踪系统。

如果你要报告的问题未出现在列表中，请登录 GitHub 报告。如果你还没有
GitHub 账号，请使用 "Sign up" 链接新建一个账号。 错误报告无法匿名提交
。

当你登录之后，就可以提交问题了。请点击顶端栏的 "New issue" 按钮来报告
新问题。

提交表单有两个字段，"Title" 和 "Comment"。

对于 "Title" 字段，请输入对问题的 *非常* 简短的描述；最好是少于十个单
词。

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

每个问题报告将由一位开发者进行审查并决定要以何种方式来修正该问题。每当
对该问题有新的处理措施时你都会收到更新的消息。

参见:

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

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


开始亲自为 Python 做贡献
========================

除了仅仅报告您所发现的错误之外，同样欢迎您提交修复它们的补丁。您可以在
Python Developer's Guide 中找到更多为 Python 打补丁的信息。如果您有任
何问题，core-mentorship mailing list 是一个友好的去处，在那里，您可以
寻求修复 Python 相关问题的答案。
