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

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

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


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

このドキュメントの不備を発見したとき、または、改善を提案したいときは、
問題点を tracker に報告してください。修正方法の案があるならば、それも
含めて。 （訳注: 日本語訳の問題については、 GitHub 上の Issue Tracker
で報告をお願いします。）

You can also open a discussion item on our Documentation Discourse
forum.

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

参考:

  Documentation bugs
     Python issue tracker に出されたドキュメントバグのリスト。

  Issue Tracking
     issue tracker への改善報告に関する作業過程の概観。

  Helping with Documentation
     Python ドキュメントへの貢献に興味がある個人へ向けた包括的なガイド
     。

  Documenting Python
     A list of GitHub pages for documentation translation and their
     primary contacts.


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


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

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