Python是一个成熟的程序开发语言,并且以稳定著称。为了维护稳定的名声,Python的开发人员很 愿意了解你在Python中发现的不足之处。
如果你在本文档中发现了错误,请在最新的在线文档http://docs.python.org/中, 使用相关页面的“添加评论”或者“建议修改”功能来提交这些错误。
所有其他的bug报告请通过Python的bug追踪系统(http://bugs.python.org/)来提交。 该bug追踪系统提供了一个Web的UI来收集相关的信息,并通知Python的开发人员。
提高错误报告的第一步就是先确实该错误是否已经被提交,这么做的好处,除了节省了开发 人员的时间,同时你也可以了解为了解决bug,我们到底做了哪些工作,也许当前的bug已经 在下一个发布版本中被解决,或者需要更多的信息(如果允许,我们很欢迎提供更多的信息)。 因此,请首先通过首页上方的搜索框来搜索我们的bug数据库。
如果你正在提交的报告还没有在我们的bug追踪系统中,退回到Python的bug追踪系统中,如果你 还没有帐号,请旁边点击“注册”的链接,并完成注册的流程。如果你还没有登陆系统,请登陆, 我们不允许匿名的提交bug报告。
当前处于登陆成功的状态,你就可以提交bug了,选择旁边的“创建”链接来打开报告bug的表格。
提交的表格有很多要填的区域,其中在”Title”中需要填入 很 精炼的描述, 少于10个字符是非常好的,在”Type”中选择你所遇到问题的类型,并且选择 Bug相关的”Component”和”Versions”。
在”Change Note”区域中,需要详细描述问题的细节,包括你期望的结果和真实产生的结果, 确定包含所有扩展的模块,以及你在使用的硬件和软件平台(包括适当的版本信息)。
每一个bug报告都将制定一个开发人员负责,他将会决定如何来解决这个bug。该bug的 每次操作的更新信息都将发送给你。
See also
本文将会更加详细的介绍如何报告一个有用的bug。 它描述了什么类型的信息是有帮助的,以及为什么是有帮助的。
关于编写一份好的bug报告,虽然其中一部分是专指Mozilla项目的,但是它提供了 一个很好的实例。
关于本评注系统
本站使用上下文关联的评注系统来收集反馈信息。不同于一般对整章做评注的做法, 我们允许你对每一个独立的“文本块”做评注。一个“文本块”看起来是这样的:
一个“文本块”是一个段落,一个列表项,一段代码,或者其他一小段内容。 你选中它会高亮度显示:
要对文本块做评注,你只需要点击它旁边的标识块:
我们会仔细阅读每个评论,如果可能的话我们也会把评注考虑到未来的版本中去:
如果你愿意你的评注被采用,请确保留下你的全名 (注意不是昵称或简称)
Many, many thanks to Jack Slocum; the inspiration and much of the code for the comment system comes from Jack's blog, and this site couldn't have been built without his wonderful
YAHOO.extlibrary. Thanks also to Yahoo for YUI itself.