Re: [討論] 要不要寫註解
整理一下討論中主張要寫註解的理由,有些比較不必要
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給連結就好了
我不會說要不要寫註解是對的還是錯的
每個人環境不同,就必須有不同的行動來對應
不過我的環境會讓我覺得要寫註解是個例外或是最後手段
如果你很需要寫上面三種註解
我會建議你考慮找新工作,你值得更好。
--
※ 發信站: 批踢踢實業坊(ptt.cc), 來自: 120.88.154.164 (澳大利亞)
※ 文章網址: https://www.ptt.cc/bbs/Soft_Job/M.1572129583.A.FB6.html
→
10/27 08:30,
4年前
, 1F
10/27 08:30, 1F
推
10/27 09:09,
4年前
, 2F
10/27 09:09, 2F
推
10/27 09:11,
4年前
, 3F
10/27 09:11, 3F
推
10/27 11:12,
4年前
, 4F
10/27 11:12, 4F
→
10/27 11:12,
4年前
, 5F
10/27 11:12, 5F
推
10/27 11:57,
4年前
, 6F
10/27 11:57, 6F
→
10/27 11:57,
4年前
, 7F
10/27 11:57, 7F
→
10/27 11:58,
4年前
, 8F
10/27 11:58, 8F
推
10/27 12:59,
4年前
, 9F
10/27 12:59, 9F
推
10/27 13:48,
4年前
, 10F
10/27 13:48, 10F
推
10/27 14:48,
4年前
, 11F
10/27 14:48, 11F
→
10/27 15:38,
4年前
, 12F
10/27 15:38, 12F
→
10/27 15:38,
4年前
, 13F
10/27 15:38, 13F
→
10/27 16:02,
4年前
, 14F
10/27 16:02, 14F
→
10/27 16:20,
4年前
, 15F
10/27 16:20, 15F
噓
10/27 18:23,
4年前
, 16F
10/27 18:23, 16F
→
10/27 20:44,
4年前
, 17F
10/27 20:44, 17F
→
10/27 20:46,
4年前
, 18F
10/27 20:46, 18F
→
10/27 20:47,
4年前
, 19F
10/27 20:47, 19F
→
10/27 23:13,
4年前
, 20F
10/27 23:13, 20F
→
10/28 13:09,
4年前
, 21F
10/28 13:09, 21F
推
10/28 14:48,
4年前
, 22F
10/28 14:48, 22F
→
10/28 14:48,
4年前
, 23F
10/28 14:48, 23F
推
10/28 20:19,
4年前
, 24F
10/28 20:19, 24F
→
10/28 20:19,
4年前
, 25F
10/28 20:19, 25F
討論串 (同標題文章)