處理錯誤 (Bug)
**************

Python 已經是一個以穩定著稱的成熟程式語言。為了維持「穩定」的信譽，開
發者們想知道任何你在 Python 中發現的缺失。

有時候自己直接修復錯誤並且送出一個修正給 Python 會比較快，因為這樣會加
速流程而且不會困擾到太多人。學習如何貢獻給 Python。


說明文件的錯誤
==============

If you find a bug in this documentation or would like to propose an
improvement, please submit a bug report on the issue tracker.  If you
have a suggestion on how to fix it, include that as well.

If the bug or suggested improvement concerns the translation of this
documentation, submit the report to the translation’s repository
instead.

你也可以在我們的說明文件 Discourse 討論區中新增一個討論事項。

If you find a bug in the theme (HTML / CSS / JavaScript) of the
documentation, please submit a bug report on the python-doc-theme
issue tracker.

也參考:

  說明文件錯誤
     一系列已被提交至 Python 問題追蹤系統的有關說明文件的錯誤。

  問題追蹤系統
     在追蹤系統上回報改進建議的過程簡介。

  貢獻說明文件
     給有意成為 Python 說明文件貢獻者的綜合指南。

  說明文件翻譯
     一份 GitHub 網頁的清單，裡面有各個說明文件翻譯團隊的連結，以及他
     們的主要聯絡人。


使用 Python 問題追蹤系統
========================

對於 Python 本身的問題報告，應該透過 GitHub 問題追蹤系統
(https://github.com/python/cpython/issues) 提交。這個 GitHub 問題追蹤
系統提供了一個網頁表單，可以輸入並提交相關資訊給開發者。

填寫報告的第一步，是確認該問題是否已經被回報過了。這樣做的好處，除了可
以節省開發者的時間，也能讓你了解目前關於該問題的處理進度；有可能已經在
下一個發行版本中修正了這個問題，也有可能需要更詳細的資訊（在這種情況下
，如果可以，非常歡迎你提供資訊！）。要確認是否重複回報，請使用頁面頂端
的搜尋框來搜尋追蹤系統。

如果你想回報的問題還沒有在問題列表出現過，請登入 GitHub。如果你還沒有
GitHub 帳戶，請點選「Sign up」連結來建立一個新的帳戶。你無法以匿名方式
提交錯誤報告。

如果已經登入，那你就可以提交問題了。請點選列表頂端區域的「New issue」
按鈕，來回報一個新的問題。

提交的表單中有兩個欄位，「Title」及「Comment」。

在「Title」欄位，輸入對該問題*非常*簡短的描述；最好少於十個單字。

在「Comment」欄位，請詳細描述該問題，包括你預期發生的情況和實際發生的
情況。請確定說明中包含了涉及到的任何擴充模組，以及你當時所使用的硬體和
軟體平台（視情況而定，可以附上版本資訊）。

每一份問題報告都會被一位開發人員查核，並由他決定要做出什麼變更來修正這
個問題。每當該問題有修正動作時，你會收到更新回報。

也參考:

  如何有效地回報錯誤
     這篇文章詳細說明如何建立一份有用的錯誤報告。它描述了什麼樣的資訊
     是有用的，以及這些資訊為什麼有用。

  錯誤撰寫指南
     撰寫一份優良錯誤報告的相關資訊。部分的文章內容是針對 Mozilla 專案
     ，但它也描述了通用的好習慣。


開始讓自己貢獻 Python
=====================

除了只是回報你所發現的錯誤之外，同樣也歡迎你提交修正它們的修補程式
(patch)。你可以在 Python 開發者指南中找到如何開始修補 Python 的更多資
訊。如果你有任何問題，核心導師郵寄清單是一個友善的地方，你可以在那裡得
到，關於 Python 修正錯誤的過程中，所有問題的答案。
