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

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

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


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

如果你在這份說明文件中發現了錯誤並想要提出改進方案，請將錯誤報告提交到
錯誤追蹤系統 (issue tracker)。如果你有相應的修正建議，請一併提交。（譯
者註：如果是繁體中文說明文件翻譯相關的錯誤，請提交到
https://github.com/python/python-docs-zh-tw/issues。）

如果錯誤或建議的改進涉及此文件的翻譯，請將報告提交到翻譯存儲庫。

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

如果你發現文件主題 (HTML / CSS / JavaScript) 中存在錯誤，請在 python-
doc-theme 問題追蹤系統上提交錯誤報告。

也參考:

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

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

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

  Documentation Translations
     A list of GitHub pages for documentation translation and their
     coordination teams.


使用 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 修正錯誤的過程中，所有問題的答案。
