Github／Bitbucketのissue機能を使って効率よくタスク管理をする〜バグ報告編〜

いなば

2016.01.07

こんにちは、フロントエンドエンジニアのいなばです。

案件の開発終盤、こんなことが起きていませんか？

納品が近づき、プロジェクトメンバーで一斉に検証作業を始める
各々バグを見つけ次第、issueを立てていく
さあ、バグをかたっぱしから片付けていきましょう

しかし、蓋を空けてみると……書き方の悪いissueが乱立！
バグの内容を把握するのに時間がかかる！

結局わからないのでissueを立てた本人に聞く→結果的にコミュニケーションコストが増える……。コミュニケーションコストを減らすためのツールなのに、やりとりが何往復もしていたら本末転倒ですよね。

そこで、今回はGithubやbitbucketのissue機能を活用したデバッグフェーズでのタスク管理のコツをご紹介します。

悪いissueと良いissueとは？

そもそも、どんなissueが“悪いissue”なのでしょうか？
例を見てみましょう。（極端な例ですが）

悪いissueの例文

ドキュメントを開こうとしたとき、表計算がクラッシュしてました。確か、表計算は図表を含んでいたような気がしないでもないような。Windowsを使用しています。これは本当によくない問題だし、これは今にでも直すべき問題だよ。ところで、このアイコンは実にむかつくね。こんな醜いアイコンを使い続けるなら、誰もこんなソフト使わないよ。あ、それとオバあちゃんがワープロについて問題があるって。ちゃんと動作しないしないらしい。では。

引用元：Open Office Issue報告ガイドライン
http://openoffice-docj.osdn.jp/tr/translated/bug_writing_guidelines.html

ひとまず分解してみましょう。

ドキュメントを開いたら表計算がクラッシュした。
表計算は図表を含んでいたかもしれないし含んでなかったかもしれない。これは本当によくない問題であり、今にでも直すべき。
Windowsを使用している。
このアイコンはむかつく。
こんな醜いアイコンを使い続けるなら、誰もこんなソフト使わない。
ワープロについて問題がある。
ちゃんと動作しないらしい。

なんだかふわっとしていますね。
アイコンは別の問題ですし、ワープロの問題はそもそも関係がなさそうです。

また、クラッシュすることの原因に図表を含んでいることが関係しているのかハッキリしませんし、WindowsのOSとアプリのバージョンもわからないので、まずは再現できる環境と手順を調べなくてはなりません。

そして再現できない場合には、issueを立てた人に詳しく聞くことになるでしょう。

良いissueの例文

Win NT4.0(Service Pack5)上で10.13.00ビルドを使用すると、添付した表計算ドキュメントを開くたびにクラッシュします。またLinux(RedHat 6.2)上で同じことをしたら、10.13.00のLinuxビルドを使っても同じことが再現できます。
そのドキュメントから図表を取り除いたら、問題なく開くことができました。

引用元：Open Office Issue報告ガイドライン
http://openoffice-docj.osdn.jp/tr/translated/bug_writing_guidelines.html

こちらも分解してみましょう。

添付した表計算ドキュメントを開くたびにクラッシュする。
Win NT4.0(Service Pack5)、またはLinux(RedHat 6.2)上で10.13.00ビルドを使うと起きる。
ドキュメントから図表を取り除くとクラッシュしない。

すっきりとしましたね。

問題点	添付した表計算ドキュメントを開くたびにクラッシュする。
再現手順	Win NT4.0(Service Pack5)、またはLinux(RedHat 6.2)上で10.13.00ビルドを使用。上記の環境で添付した表計算ドキュメントを開く。
ゴール	Win NT4.0(Service Pack5)、またはLinux(RedHat 6.2)上の10.13.00ビルドで添付した表計算ドキュメントを開いても、クラッシュしないようにする。