Issue には To-Be と Why を書いてくれるとうれしい
Posted at # project management
PMの皆様、いつも issue を書いてくれてありがとう。 1つだけお願いがあります。 How(方法)のみのだとモヤッとする issue が「Aリストから○○を削除する」といった具体的な作業手順(How)のみに言及するケースがあります。 このケースだとエンジニアが疑問を抱え、着手に時間がかかることが多いです。 ○○を消す理由は? ○○は別の場所にもあるけどそれも消す? 消すとは非表示するだけ?それともコードからも消す? API側の制御も入れる? 具体的な How を書いてしまうと、実は○○は別箇所にもあるのにAリストのみを消しただけになる。という影響範囲漏れを誘発することにもつながります。 Why(理由)と To-Be(あるべき姿)を教えて 『ログを見た感じ、○○は使われてない機能なので削除が決定した。よって○○を削除お願いします。』 のように、 Why:ログから使われていない機能だ