バグ報告の方法

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page How to report a bug and the translation is 96% complete.

Other languages:
Bahasa Indonesia • ‎Bahasa Melayu • ‎Cymraeg • ‎Deutsch • ‎English • ‎Esperanto • ‎Hawaiʻi • ‎Interlingue • ‎Kreyòl ayisyen • ‎Lëtzebuergesch • ‎Napulitano • ‎Nederlands • ‎Ripoarisch • ‎Scots • ‎Taqbaylit • ‎Tiếng Việt • ‎Türkçe • ‎aragonés • ‎asturianu • ‎català • ‎dansk • ‎español • ‎euskara • ‎français • ‎galego • ‎hrvatski • ‎interlingua • ‎italiano • ‎kurdî • ‎lietuvių • ‎magyar • ‎norsk bokmål • ‎occitan • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎shqip • ‎sicilianu • ‎slovenčina • ‎suomi • ‎svenska • ‎čeština • ‎Ελληνικά • ‎беларуская (тарашкевіца)‎ • ‎български • ‎русский • ‎српски / srpski • ‎татарча/tatarça • ‎українська • ‎ייִדיש • ‎עברית • ‎ئۇيغۇرچە • ‎العربية • ‎تۆرکجه • ‎سنڌي • ‎فارسی • ‎پښتو • ‎मराठी • ‎हिन्दी • ‎মেইতেই লোন্ • ‎ਪੰਜਾਬੀ • ‎ଓଡ଼ିଆ • ‎தமிழ் • ‎తెలుగు • ‎ಕನ್ನಡ • ‎සිංහල • ‎ไทย • ‎ქართული • ‎ትግርኛ • ‎ᱥᱟᱱᱛᱟᱲᱤ • ‎中文 • ‎日本語 • ‎粵語 • ‎한국어
ショートカット: BUGREPORT

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

タスクは英語で書く必要があります。英語で書けない場合は、Google 翻訳などの機械翻訳ツールをお試しください。

報告の要点

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

何かをする前に

問題点を再現できますか?

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

他の誰かが既に報告した問題点ではありませんか?

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

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

問題を自力で解決しようと試みましたか?

問題によっては使用する利用者スクリプトやガジェットのエラーが原因かもしれません。 問題のレポートで時間をつぶすよりも、それらコードを探す手順のガイドに従うと 問題が解決できる可能性があります。

新しいバグの報告や指摘

最新バージョンでバグが見つかり、それが他の誰もまだ報告していないバグであれば:

  1. phabricator.wikimedia.org に移動します。
  2. ログイン (または登録) する必要がありますので、求められた場合はそうしてください (アカウントの作成 を参照してください)。
  3. Click the star in the upper right corner and choose "Create Task" (or "Report Security issues" to report a security problem ).
  4. 以下のうち少なくともひとつの項目に記入してください:
    • Title(題名): (あなたが提案する解決法ではなく) 問題点を説明する短い要約を述べた1文。
      • いい例: "Selecting gender is not functional."
      • 悪い例: "Software crashes."
    • 割り当て: このフィールドは無視すべきです: 開発者がタスクに取りかかる計画を立てると、受け持つ人を指名します。
    • Description (説明): 問題点の詳細をできるだけ詳しく書いてください。以下の内容を含めることができます:
      • バグの場合:
        • Steps to Reproduce (再現の手順): 述べられている問題を引き起こすための、簡単に行える最小の手順を書いてください。特殊な準備手順があれば書いてください。
          例:
          1. Go to https://en.wikipedia.org with Internet Explorer version 10.0;
          2. Make sure you are logged in;
          3. Select "My Preferences" menu;
          4. Go to "Gender" and select female gender from box list;
          5. Click "Save" button.
        • Actual Results (実際の結果): 上記の手順をたどったとき、アプリケーションが行ったこと。
          例:
          "There is no female gender in front of my user name."
        • Expected Results (期待される結果): バグがない場合にアプリケーションが行うべきだったこと。
          例:
          "My gender is shown in front of my user name."
      • 機能の要望の場合:
        • あなたが望むものとその理由の記述。 Explain what you hope the feature will solve (the actual underlying problem) along with specific examples; but do not demand a specific solution, as there might be other/better solutions. ユーザー ストーリーは、要望の伝達方法として効果的です。
          例:
          "As a new editor, I would like to be acknowledged for my contribution to the project, so that I feel welcomed and valued"
      • 他に有用かもしれない情報があれば書いてください。例えば:
        • そのバグに遭遇したとき使用していたブラウザー、外装 (スキン)、コンピューターシステム
        • そのバグに遭遇したページ (複数可) の差分またはリンク
        • 問題がいつも生じるか、一部のページや特定の条件でだけ生じるか
    • ログファイルやスクリーンショット を添付する場合 (ただし決して機密情報をふくんだり表示したりしないように) 、Description フィールドにある Upload File ボタン (雲に矢印の形) をクリックします。
    • バグが見つかったタグ (プロジェクト) を選択してください:
      • 開発者はプロジェクトを利用して作業するタスクを探します。検索機能(右上)を使用して説明を探し、適切なプロジェクトを特定します。
      • 例えばウィキソフトウェア自体の場合は MediaWiki-General-or-Unknown プロジェクト、ウィキメディアのサイトの設定の場合は Wikimedia-Site-Requests などとなります (「Selecting projects 」を参照)。
    • 購読者: このタスクについて連絡を受けたそうな利用者を、具体的に思い当たるなら、その人をここに追加してください。 さもなければ、このフィールドは気にしなくて構いません。

報告が完成したことを確認してから、"Create Task" ボタンをクリックしてください。バグ報告がデータベースに登録されます。 This allows somebody interested in the report to look at it and potentially work on it .

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

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

JavaScript のバグの報告

参照: Help:Locating broken scripts

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

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

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

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

接続性の問題の報告

もしWikimediaのウェブサイトに接続するのに困難がある場合は(インターネット接続が遅い、など)、wikitech:Reporting a connectivity issueに従って下さい。

ログインの問題点の報告

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

関連項目

  • phab:T85433 Using Phabricator for gadget-related tasks