整理一下討論中主張要寫註解的理由，有些比較不必要
1. 程式的why 「寫個一行10~20個字這個method幹麻」
這個可以寫在test spec中。特別是BDD的testing lib的desribe還可以套很多層
應該夠你寫了
2. 責任分配 「// 此功能因某某某要求故加上」
這個應該是寫在commit message，或是commit message上打issue系統的id
從issue可以看到開票的人和理由
3. 商業邏輯 「IFRS制度變換」
提出這個理由的人真的會在註解寫那麼多嗎？
要實作什麼需要應該是PM會寫user story，在commit message給連結就好了
我不會說要不要寫註解是對的還是錯的
每個人環境不同，就必須有不同的行動來對應
不過我的環境會讓我覺得要寫註解是個例外或是最後手段
如果你很需要寫上面三種註解
我會建議你考慮找新工作，你值得更好。