バグへの対処
************

Python は安定性について高い評価を得た、成熟した言語です。この評価を守
るために、開発者たちはあなたが見つけた Python の不備を知りたいと思って
います。

バグを自分で直して Python にパッチを送る方が、やり取りに無駄が無く関わ
る人数も少なく済むこともあります。 ぜひ コントリビュート する方法を学
んでください。


ドキュメントの不備
==================

このドキュメントに不備を発見したり、改善を提案したいと思った場合、バグ
報告を tracker に送信してください。もし修正案があれば、それも含めてく
ださい。

時間がない場合は、ドキュメントに関するバグを docs@python.org 宛に報告
することもできます。 (Python の動作に関するバグ報告は python-
list@python.org 宛になります。) 'docs@' はボランティアによって運営され
ているメーリングリストです。 報告は伝わっていますが、対応には時間がか
かるかもしれません。

参考: Python の課題管理システムの Documentation bugs


Python の課題管理システムを使う
===============================

Python 自体のバグの報告は Python Bug Tracker
(https://bugs.python.org/) を通じて投稿してください。このバグトラッカ
ーは、関連情報を入力して開発者に報告するための Web フォームを提供して
います。

報告ではまず、その問題が既に報告済みかどうかを判断してください。そのメ
リットには開発者の時間を節約する以外にも、問題解決のためになされてきた
ことを知ることができるということもあります。問題は次のリリースで解決済
みかもしれませんし、さらなる情報を必要としている (可能なら是非提供して
ください！)かもしれません。判断するには、ページの先頭の検索ボックスで
バグデータベースを検索してください。

問題がまだバグトラッカーに登録されていない場合は、Python Bug Tracker
のトップページに戻ってログインしてください。まだトラッカーのアカウント
をもっていない場合は、サイドバーの "Register" リンクを選んでください。
また、OpenID を使っている場合はサイドバーの OpenID プロバイダのロゴを
クリックしてください。匿名での問題報告はできません。

ログインできたら、バグを登録できます。サイドバーの "Create New" リンク
からバグ報告フォームを開きます。

バグ報告フォームには幾つかのフィールドがあります。"Title" フィールドに
は、問題の説明を *非常に* 簡潔に書いてください。10語以下くらいが目安で
す。"Type" フィールドでは、問題の種類を選択してください。バグに関係す
る "Component" と "Versions" も選択してください。

"Comment" フィールドで、あなたが期待した結果と実際の結果も含め、問題の
詳細を説明してください。拡張モジュールが関与しているかどうかと、使用し
ているハードウェアとソフトウェアプラットフォームも (必要に応じてバージ
ョン情報も) 必ず報告に含めてください。

各バグ報告は開発者に割り当てられ、その問題を解決するのに何が必要かが決
定されます。そのバグ報告に対して何かアクションがあるたびに、更新情報が
あなたに届きます。

参考:

  How to Report Bugs Effectively
     有益なバグ報告について詳しく説明した記事です。どんな情報が、なぜ
     有益なのかを説明しています。

  Bug Writing Guidelines
     良いバグ報告を書くための情報です。この情報の一部はMozillaプロジェ
     クト独自のものですが、一般的に良い習慣を解説しています。


Python への貢献をはじめる
=========================

見つけたバグの報告だけでなく、修正パッチの提出も歓迎します。Python
Developer's Guide には Python へのパッチの始め方について詳しい情報があ
ります。疑問があれば、core-mentorship mailing list は Python の問題解
決の過程に関するありとあらゆる疑問への答えを得ることが出来るフレンドリ
ーな場所です。
