バグへの対処¶
Python は安定性について高い評価を得た、成熟した言語です。この評価を守るために、開発者たちはあなたが見つけた Python の不備を知りたいと思っています。
バグを自分で直して Python にパッチを送る方が、やり取りに無駄が無く関わる人数も少なく済むこともあります。 ぜひ 貢献 する方法を学んでください。
ドキュメントの不備¶
このドキュメントの不備を発見したとき、または、改善を提案したいときは、問題点を tracker に報告してください。修正方法の案があるならば、それも含めて。 （訳注: 日本語訳の問題については、 GitHub 上の Issue Tracker で報告をお願いします。）
時間がない場合、ドキュメントの問題を docs@python.org 宛て、メールで報告することもできます。 (Python の動作に関するバグ報告は python-list@python.org 宛になります。) 'docs@' はボランティアで運営されているメーリングリストです。 報告が伝わっていても、対応への時間がかかることもあります。
参考
- Documentation bugs
Python issue tracker に出されたドキュメントバグのリスト。
- Issue Tracking
issue tracker への改善報告に関する作業過程の概観。
- Helping with Documentation
Python ドキュメントへの貢献に興味がある個人へ向けた包括的なガイド。
Python の課題管理システムを使う¶
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" フィールドで、あなたが期待した結果と実際の結果も含め、問題の詳細を説明してください。拡張モジュールが関与しているかどうかと、使用しているハードウェアとソフトウェアプラットフォームも (必要に応じてバージョン情報も) 必ず報告に含めてください。
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.
参考
- How to Report Bugs Effectively
有益なバグ報告について詳しく説明した記事です。どんな情報が、なぜ有益なのかを説明しています。
- Bug Report Writing Guidelines
良いバグ報告を書くための情報です。この情報の一部はMozillaプロジェクト独自のものですが、一般的に良い習慣を解説しています。
Python への貢献をはじめる¶
見つけたバグの報告だけでなく、修正パッチの提出も歓迎します。Python Developer's Guide には Python へのパッチの始め方について詳しい情報があります。疑問があれば、core-mentorship mailing list は Python の問題解決の過程に関するありとあらゆる疑問への答えを得ることが出来るフレンドリーな場所です。