處理錯(cuò)誤?

Python 是一門成熟的編程語(yǔ)言,以穩(wěn)定著稱。為維持其美譽(yù),開發(fā)者希望獲悉所有您在 Python 中發(fā)現(xiàn)的缺陷。

有時(shí)候自己修復(fù)漏洞并將補(bǔ)丁提交給 Python 能更快地解決問(wèn)題,因?yàn)樗?jiǎn)化了流程并且減少了參與的人力。 請(qǐng)參閱如何 提交補(bǔ)丁。

文檔 Bug?

如果您在本文檔中發(fā)現(xiàn)了錯(cuò)誤并打算幫助我們改進(jìn),請(qǐng)將錯(cuò)誤提交到 追蹤系統(tǒng)。 如果您有相應(yīng)的修正建議,請(qǐng)一并提交。 (譯者注:如果是中文文檔翻譯相關(guān)的錯(cuò)誤,請(qǐng)務(wù)必提交到 https://github.com/python/python-docs-zh-cn/issues。如果將翻譯問(wèn)題反饋到了其他地方,可能會(huì)因?yàn)檎Z(yǔ)言不通而不能及時(shí)處理。)

如果您時(shí)間有限,還可以通過(guò)電子郵件將文檔的錯(cuò)誤報(bào)告發(fā)送至 docs@python.org(代碼運(yùn)行錯(cuò)誤請(qǐng)發(fā)送至 python-list@python.org)?!癲ocs@”是一個(gè)由志愿者運(yùn)作的郵件列表;您的請(qǐng)求會(huì)得到關(guān)注,但可能需要一些時(shí)間才會(huì)被處理。

參見

Documentation bugs

已提交給 Python 問(wèn)題追蹤系統(tǒng)的文檔錯(cuò)誤列表。

問(wèn)題跟蹤

在追蹤系統(tǒng)上參與問(wèn)題改進(jìn)的過(guò)程概述。

改進(jìn)文檔

給有興趣為 Python 文檔做出貢獻(xiàn)的人。

Documentation Translations

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

使用 Python 的問(wèn)題追蹤系統(tǒng)?

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.

在“說(shuō)明(Comment)”欄,請(qǐng)?jiān)敿?xì)描述問(wèn)題,包括您預(yù)期的情況和實(shí)際的情況。請(qǐng)確保包含任何涉及的拓展模塊,以及您當(dāng)時(shí)所使用的硬件和軟件平臺(tái)(如果可能,請(qǐng)附上版本信息)。

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.

參見

如何有效地報(bào)告錯(cuò)誤

該文章詳細(xì)介紹了如何創(chuàng)建一份有用的錯(cuò)誤報(bào)告。它描述了什么樣的信息是有用的,以及為什么是有用的。

Bug Writing Guidelines

關(guān)于寫一份好的錯(cuò)誤報(bào)告。部分僅針對(duì) Mozilla 項(xiàng)目,不過(guò)其描述了通用的恰當(dāng)做法。

開始為 Python 貢獻(xiàn)您的知識(shí)?

除了僅僅報(bào)告您所發(fā)現(xiàn)的錯(cuò)誤之外,同樣歡迎您提交修復(fù)它們的補(bǔ)丁。您可以在 Python 開發(fā)者指引 中找到更多為 Python 打補(bǔ)丁的信息。如果您有任何問(wèn)題,核心導(dǎo)師郵件列表 是一個(gè)友好的去處,在那里, 你可以尋求修復(fù) Python 相關(guān)問(wèn)題的答案。