處理錯誤?
Python 是一門成熟的編程語言,以穩(wěn)定著稱。為維持其美譽,開發(fā)者希望獲悉所有您在 Python 中發(fā)現(xiàn)的缺陷。
有時候自己修復(fù)漏洞并將補丁提交給 Python 能更快地解決問題,因為它簡化了流程并且減少了參與的人力。 請參閱如何 提交補丁。
文檔 Bug?
如果您在本文檔中發(fā)現(xiàn)了錯誤并打算幫助我們改進(jìn),請將錯誤提交到 追蹤系統(tǒng)。 如果您有相應(yīng)的修正建議,請一并提交。 (譯者注:如果是中文文檔翻譯相關(guān)的錯誤,請務(wù)必提交到 https://github.com/python/python-docs-zh-cn/issues。如果將翻譯問題反饋到了其他地方,可能會因為語言不通而不能及時處理。)
如果您時間有限,還可以通過電子郵件將文檔的錯誤報告發(fā)送至 docs@python.org(代碼運行錯誤請發(fā)送至 python-list@python.org)?!癲ocs@”是一個由志愿者運作的郵件列表;您的請求會得到關(guān)注,但可能需要一些時間才會被處理。
參見
- Documentation bugs
已提交給 Python 問題追蹤系統(tǒng)的文檔錯誤列表。
- 問題跟蹤
在追蹤系統(tǒng)上參與問題改進(jìn)的過程概述。
- 改進(jìn)文檔
給有興趣為 Python 文檔做出貢獻(xiàn)的人。
- Documentation Translations
A list of GitHub pages for documentation translation and their primary contacts.
使用 Python 的問題追蹤系統(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.
在“說明(Comment)”欄,請詳細(xì)描述問題,包括您預(yù)期的情況和實際的情況。請確保包含任何涉及的拓展模塊,以及您當(dā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.
參見
- 如何有效地報告錯誤
該文章詳細(xì)介紹了如何創(chuàng)建一份有用的錯誤報告。它描述了什么樣的信息是有用的,以及為什么是有用的。
- Bug Writing Guidelines
關(guān)于寫一份好的錯誤報告。部分僅針對 Mozilla 項目,不過其描述了通用的恰當(dāng)做法。
開始為 Python 貢獻(xiàn)您的知識?
除了僅僅報告您所發(fā)現(xiàn)的錯誤之外,同樣歡迎您提交修復(fù)它們的補丁。您可以在 Python 開發(fā)者指引 中找到更多為 Python 打補丁的信息。如果您有任何問題,核心導(dǎo)師郵件列表 是一個友好的去處,在那里, 你可以尋求修復(fù) Python 相關(guān)問題的答案。