How to report a bug/ja

このガイドラインは、適切なバグ報告の仕方やウィキメディアのバグトラッカー (詳細は を参照してください) における指摘法を解説しています. バグ報告は適切に書かれているほど修正されやすくなります.

報告を行う際の要点

 * 簡潔に.
 * 明瞭に. 他の人がそのバグを再現できるよう、問題の再現方法を手順を追って説明してください.
 * 1つの報告では1つの問題のみを扱ってください.

問題点を再現できますか?
あなたのバグ最新のソフトウェアで再現されるかどうかを試し、すでに修正されているかどうかを調べてみてください. ウィキペディア等のウィキサイトでそのバグが起こっているなら、最新バージョンのソフトウェアをtest2.wikipedia.orgで試すことができます.

他の誰かが既に報告した問題点ではありませんか?
ウィキメディアのバグトラッカーの検索ボックスを使用し、あなたのバグが既に報告されたかどうかを確認して下さい. 詳細な検索ページを用いて、より細かい条件での検索も行えます.

新しいバグの報告や指摘
最新バージョンでバグが見つかり、それが他の誰もまだ報告していないバグであれば：
 * 1) phabricator.wikimedia.org に移動し、サイドバーにある「Maniphest」をクリックします.
 * 2) 右上隅の「Create task (タスクを作成)」を選択します.
 * 3) ログイン (または登録) が求められます. (""をお読みください)
 * 4) 以下のうち少なくともひとつの項目に記入してください：
 * 5) * Title(題名): (あなたが提案する解決法ではなく) 問題点を説明する短い要約を述べた1文.
 * 6) ** いい例:
 * 7) ** 悪い例:
 * 8) * 割り当て: このフィールドは無視すべきです: 開発者がタスクに取りかかる計画を立てると、受け持つ人を指名します.
 * 9) * CC: このフィールドは無視すべきです: このタスクについて連絡を受けたそうな利用者を、具体的に思い当たるなら、その人をここに追加することができます.
 * 10) * 優先順位: このフィールドは無視すべきです: ふつう開発者がタスクの実行を計画するときに優先順位を決めます (""も参照してください).
 * 11) * バグが見つかったプロジェクトを選択してください:
 * 12) **Projects are how developers find tasks to work on. To identify the right project(s), use the search function (in the top right) to find its description.
 * 13) **例えばウィキソフトウェア自体の場合は プロジェクト、ウィキメディアのサイトの設定の場合は  などとなります (「」を参照).
 * 14) * セキュリティ: このフィールドは報告しようとしているセキュリティの問題で多くの利用者に害が及ぶ場合、 "セキュリティもしくは敏感なバグ" に設定します. 寄せられた報告は解決するまで公開しません.
 * 15) * Description (説明): 問題点の詳細をできるだけ詳しく書いてください. 以下の内容を含めることができます:
 * 16) ** バグの場合:
 * 17) *** Steps to Reproduce (再現の手順): 述べられている問題を引き起こすための、簡単に行える最小の手順を書いてください. 特殊な準備手順があれば書いてください.
 * 例:
 * 1) *** Actual Results (実際の結果): 上記の手順をたどったとき、アプリケーションが行ったこと.
 * 例:
 * 1) ***Expected Results (期待される結果): バグがない場合にアプリケーションが行うべきだったこと.
 * 例:
 * 1) ** 機能の要望の場合:
 * 2) *** あなたが望むものとその理由の記述. |ユーザー・ストーリーは、要望の伝達方法として効果的です.
 * 例:
 * 1) **他に有用かもしれない情報があれば書いてください. 例えば:
 * 2) ***そのバグに遭遇したとき使用していたブラウザー、外装 (スキン)、コンピューターシステム
 * 3) ***そのバグに遭遇したページ (複数可) の差分またはリンク
 * 4) ***問題がいつも生じるか、一部のページや特定の条件でだけ生じるか
 * 5) *ログファイルや を添付する場合 (ただし決して機密情報をふくんだり表示したりしないように) 、Description フィールドにある Upload File ボタン (雲に矢印の形) をクリックします.
 * 1) *** あなたが望むものとその理由の記述. |ユーザー・ストーリーは、要望の伝達方法として効果的です.
 * 例:
 * 1) **他に有用かもしれない情報があれば書いてください. 例えば:
 * 2) ***そのバグに遭遇したとき使用していたブラウザー、外装 (スキン)、コンピューターシステム
 * 3) ***そのバグに遭遇したページ (複数可) の差分またはリンク
 * 4) ***問題がいつも生じるか、一部のページや特定の条件でだけ生じるか
 * 5) *ログファイルや を添付する場合 (ただし決して機密情報をふくんだり表示したりしないように) 、Description フィールドにある Upload File ボタン (雲に矢印の形) をクリックします.
 * 1) *ログファイルや を添付する場合 (ただし決して機密情報をふくんだり表示したりしないように) 、Description フィールドにある Upload File ボタン (雲に矢印の形) をクリックします.

報告が完成したことを確認してから、"Create Task" ボタンをクリックしてください. バグ報告がデータベースに入りますので、しばらくすれば誰かが見てくれるでしょう.

以上です. MediaWikiとウィキメディアプロジェクトの改善にご協力くださいましてありがとうございます.

JavaScript のバグの報告
Javascriptに関するバグを見つけた時は、できるだけエラーメッセージを見つけ、バグ報告に含めるようにしてください.

システム管理者でさえエラーログにアクセスすることができないため、あなたのところにある情報をすべて提供していただくことが特に重要です. 利用している機能がJavaScriptによるものかわからないときは、JavaScriptを無効化してみてください.

バグ報告にスクリーンショットを入れていただけると助けになります. スクリーンショットは、あなたの指している機能を特定するのに最も簡単な方法であることが多いです. また、エラーを絞り込むのに役立つ情報をもたらすことがしばしばあります. 他に開いているタブ、最小化されたチャット画面など、共有したくない情報はすべて隠すよう気をつけてください.

関連項目

 * 効果的なバグ報告の方法 (Simon Tatham 著)
 * Wikipedia: Bug reports and feature requests (英語)
 * ja:Wikipedia:バグの報告 (日本語)
 * Phabricatorを使う際の注意
 * Bug management/Bug report life cycle
 * Writing a good bug report or feature request
 * How to create a good first Bug Report (outdated)