Bug writing guidelines

Mozilla 製品 (Firefox や Thunderbird など) に関するサポートが必要なら、提供されているいずれかの サポートオプション をご利用ください。このページを編集しないようお願いします。

Mozilla の QA に初めて参加される場合は、より経験を積んだ貢献者の助けを借りてみましょう。QA ページの「コミュニティ」という項目に、他の貢献者と出会える場所が書かれています。 Firefox のバグを報告されるなら、irc.mozilla.org の #firefox チャンネルで協力を求めることもできます。

原則

有用なバグ報告ほど修正される可能性が上がります。このガイドラインではそうした報告の書き方について説明します。

  • 正確に
  • 明確に - 他の人もバグを再現できるよう、状況をはっきりと説明してください
  • 報告 1 件につきバグ 1 件です
  • どんな些細なバグでも報告してください - 小さなバグの裏に大きなバグが潜んでいる可能性があります
  • 事実と推測をしっかり区別してください

事前準備

  1. 該当する製品の 最新のビルド を使ってバグを再現し、すでに修正されていないかどうか確認してください。
  2. Bugzilla を検索し、バグがすでに報告されていないかどうか確認してください。(チュートリアル)

新しいバグを報告する

最新のビルドでバグが再現し、誰もまだ報告していないようなら、次のステップへ進んでください。

  1. Enter a new bug」を選びます (このフォームはこのガイドラインの一部を組み込んだものです)
  2. あなたがバグを見つけた製品を選びます。
  3. フォームに記入します。以下はフォームの各項目の意味です。

Component: 製品のどの部分そのバグを見つけましたか?

この項目は必須です。「Component」のリンクをクリックすると、各コンポーネントの説明を見ることができます。もしどれにも当てはまらないと思ったら「General」を選択してください。

OS: どのオペレーティングシステム (OS) でそのバグを見つけましたか? (Linux、Windows XP、Mac OS X など)

複数の OS でそのバグが見られることが分かっている場合は「All」を選択してください。お使いの OS がリストにない場合は「Other」を選択してください。

Summary: そのバグについて、およそ 60 文字以内で説明してください。

良い要約を書けば、すばやく、そして間違いなくそのバグ報告を特定できます。解決策を提示するのではなく、問題そのものを説明してください。

  • 良い例: "Cancelling a File Copy dialog crashes File Manager"
  • Bad: "Software crashes"
  • Bad: "Browser should work with my web site"

Description: バグ報告の詳細です。以下の項目を含めてください。

Overview: より詳細な要約。

Drag-selecting any page crashes Mac builds in the NSGetFactory function.

Steps to Reproduce: バグを引き起こすのに必要な、最小限の、簡単に実行できる手順。特別な条件があればそれも書いてください。

1) View any web page. (I used the default sample page, 
resource:/res/samples/test0.html)

2) Drag-select the page. (Specifically, while holding down 
the mouse button, drag the mouse pointer downwards from any 
point in the browser's content region to the bottom of the 
browser's content region.)

Actual Results: 上記の手順を実行するとどのような結果が見られるかを書いてください。

The application crashed.

Expected Results: バグがない場合、どのような結果になるべきかを書いてください。

The window should scroll downwards. Scrolled content should be selected. 
(Or, at least, the application should not crash.)

Build Date & Platform: 初めてそのバグを見つけたビルドの日付とプラットフォーム。

Build 2006-08-10 on Mac OS 10.4.3

Additional Builds and Platforms: そのバグが他のプラットフォーム (場合によってはブラウザ) でも見られるかどうか。

Doesn't Occur On Build 2006-08-10 on Windows XP Home (Service Pack 2)

Additional Information: その他の役に立つ情報。

クラッシュバグについては、以下の内容を報告してください。

  • Win32: ワトソン博士 【訳注: Windows に付属するクラッシュ報告ツール】 のエラーが表示された場合は、クラッシュの種類や、アプリケーションのどのモジュールでクラッシュしたかを書いてください。 (例: access violation in mozilla.exe)
  • Mac OS X: アプリケーションがクラッシュした場合は、表示された通知ウィンドウで [Report] ボタンをクリックします。[Problem and system information] の下にあるテキストボックスからテキスト全文をコピーして、フォームに貼り付けてください。バグを Apple に送る必要はありません。ウィンドウの左上にある赤い閉じるボタンを押してください。
  • Unix: シェルプロンプトに gdb mozilla core と入力して得られる最小限のスタックトレースを提供してください。
Date/Time:      2006-12-26 12:15:20.089 -0500
OS Version:     10.4.8 (Build 8L2127)
Report Version: 4

Command: firefox-bin
Path:    /Applications/Firefox.app/Contents/MacOS/firefox-bin
Parent:  WindowServer [71]

Version: 2.0.0.1 (2.0.0.1)

PID:    114
Thread: 0

Exception:  EXC_BAD_ACCESS (0x0001)
Codes:      KERN_PROTECTION_FAILURE (0x0002) at 0x000000ca

Thread 0 Crashed:
0   libxpcom_core.dylib 	0x0186329b AppendUTF8toUTF16(char const*, nsAString_internal&) + 31
1   libxpcom_core.dylib 	0x01822916 nsTextFormatter::smprintf_free(unsigned short*) + 3248
... (many many more lines like this) ...

Add an attachment: 関連ファイルをバグ報告に添付することができます。20 行以上のデバッグ情報は添付ファイルの形で提供してください。また、バグを実証する HTML ファイルをお持ちの場合は、それを添付してください。最初の送信時には 1 つしかファイルを添付できませんので、複数ファイルがある場合は、一度バグを登録してから改めて添付してください。付属のファイル (画像など) がある場合はまずそれを添付して、HTML ファイルをアップロードする前に画像の URL を書き換えてください。そうすることでデモを「自己完結」できます。5 つ以上のファイルを添付する場合は事前に担当者に相談してください。

内容に間違いや記入漏れがないことを再度確認してから「Commit」ボタンを押してください。これであなたのバグ報告は Bugzilla のデータベースに入りました。

原文書の情報

  • 著者: Gervase Markham, based on an original by Eli Goldberg
  • 貢献者: Claudius Gayle, Jan Leger, Felix Miata, Peter Mock, Chris Pratt, Chris Yeh, and others.

Document Tags and Contributors

タグ:
Contributors to this page: saneyuki_s, Kohei, ethertank, Yoshino, Mgjbot
最終更新者: ethertank,