How to report a bug/ja

このガイドラインは、ウィキメディアのタスクトラッカー (詳細は を参照してください) における、適切なバグ報告や機能追加リクエスト（タスク）の書き方について解説しています. タスクは適切に書かれているほど実行されやすくなります.

報告の要点

 * 正確に.
 * 明瞭に. 他の人がそのバグを再現できるよう、問題の再現方法を順序立てて説明してください.
 * 1つのタスクでは1つの問題のみを扱ってください.
 * 関連のあるリンクや例を含めてください.

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

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

バグが既に報告されているかどうか不明な場合は、そのバグを報告すべきです. バグが報告されないままになるよりは、重複してもバグが報告された方がよいです.

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

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

タスクの優先度は、開発者がタスクの実行を計画するときに決めます (優先度の設定 も参照してください).

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

JavaScript のバグの報告

 * 参照: Help:Locating broken scripts

JavaScript に関連する可能性があるバグを見つけた時は、できるだけ[Special:MyLanguage/Help:Locating broken scripts エラーメッセージを特定し]、バグ報告にコピーしてください.

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

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

問題がユーザースクリプトのコードあるいはガジェット本体にある場合、取り扱う場所は Phabricator ではないかもしれません. 他のユーザーがスクリプトの議論のページにリダイレクトしてくれることがあります（問題のあるスクリプトが特定できた場合）.

接続性の問題の報告
もしWikimediaのウェブサイトに接続するのに困難がある場合は（インターネット接続が遅い、など）、Reporting a connectivity issueに従って下さい.

ログインの問題点の報告
アカウントにログインできない場合は、Manual:How to debug/Login problemsの手順に従ってください.

関連項目

 * 効果的なバグ報告の方法 (Simon Tatham 著)
 * 開発者コミュニティに問題を解決してもらうには (User:MSchottlender-WMF, 2017年7月)
 * Phabricatorを使う際の注意
 * バグの管理/バグ報告のライフサイクル
 * バグ報告や機能追加リクエストの良い書き方
 * 初めてバグを報告するときのコツ (最新の状態を反映していません)
 * Wikipedia: Bug reports and feature requests (英語)
 * ja:Wikipedia:バグの報告 (日本語)