OpenCVのissueを発行する前に

OpenCVのissueを発行する前に

はじめに

OpenCVを使っていく上で以下のような問題に直面することがあります．

• ビルドできない
• 動作がおかしい

ただし，「ビルドできない」，**「動かない」**など漠然とした報告をしてしまうと開発者が現象を再現させられずに調査が進まないことがあります．そのため，OpenCVのissueを発行する際に個人的に注意している点をまとめます．

ビルドできない

1. 既知の問題かどうかを調べる

• masterブランチでも再現するか確認する
• https://github.com/opencv/opencv/issues で同様の問題がないか探す
• http://answers.opencv.org で同様の問題がないか探す

1. issueを出すための情報収集
   開発者が現象を再現させるために以下の情報を整理する

• OpenCVバージョン
• OS
• コンパイラ
• エラーメッセージ
• CMakeオプション（CMakeで生成されたCMakeCache.txtを提出してもよい）
• etc...

1. issue発行

• 2. の情報をもとに https://github.com/opencv/opencv/issues にてissueを発行

動作がおかしい

1. 既知の問題かどうかを調べる

• masterブランチでも再現するか確認する
• https://github.com/opencv/opencv/issues で同様の問題がないか探す
• http://answers.opencv.org で同様の問題がないか探す

1. 仕様通りに実装しているか確認する

• http://docs.opencv.org/ を読み，API仕様に則った使い方をしているか確認する

1. issueを出すための情報収集
   開発者が現象を再現させるために以下の情報を整理する

• OpenCVバージョン
• OS
• コンパイラ
• エラーメッセージ
• CMakeオプション（CMakeで生成されたCMakeCache.txtを提出してもよい）
• cv::getBuildInformation()で表示されるメッセージ情報
• 現象を再現させるための情報（再現手順、再現コード、再現データ）
• etc...

1. issue発行

• 3. の情報をもとに https://github.com/opencv/opencv/issues にてissueを発行