バグへの対処

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

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

ドキュメントの不備

このドキュメントの不備を発見したとき、または、改善を提案したいときは、問題点を tracker に報告してください。修正方法の案があるならば、それも含めて。

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

参考

Documentation bugs

A list of documentation bugs that have been submitted to the Python issue tracker.

Issue Tracking

Overview of the process involved in reporting an improvement on the tracker.

Helping with Documentation

Comprehensive guide for individuals that are interested in contributing to Python documentation.

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 Report Writing Guidelines

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

Python への貢献をはじめる

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