看板 Soft_Job 關於我們 聯絡資訊
整理一下討論中主張要寫註解的理由,有些比較不必要 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
KeyFSN: 我覺得你還是不要太自信... 10/27 08:30
yamakazi: 我猜的啦 很多版友的公司其實沒有用issue tracker 10/27 09:09
yamakazi: 不然怎麼會有人想把2 3 寫進程式碼註解 10/27 09:11
abccbaandy: 很多issue tracker是給上面看的,實際需求又是另一回 10/27 11:12
abccbaandy: 事 10/27 11:12
dalconan: 2還有種狀況是開發新功能時發現和舊功能有衝突的特例 10/27 11:57
dalconan: 這時候的commit msg可能會是在說明新功能,除非硬拆一個 10/27 11:57
dalconan: 寫這個區塊的特例commit 10/27 11:58
onlyeric23: 雖然是老議題卻仍是能看到濫用註解的案例 10/27 12:59
GGFACE: 我覺得你還是不要太自信... 10/27 13:48
anandydy529: 有些公司都用資料夾版控,你還要求開issue 10/27 14:48
keke0421: 你連程式碼上面的註解都懶得寫 我就不信你會寫在jira 10/27 15:38
keke0421: or test spec 10/27 15:38
superpai: 不要太自信是什麼梗? 10/27 16:02
t64141: 重點是最後一段阿 10/27 16:20
alihue: 多的是,邏輯很簡單,但不知道為何要這麼做,你又不敢拔的 10/27 18:23
Lomonosov: 有點好奇你test spec是寫的多好懂會比一段文字還好懂 10/27 20:44
superpai: test spec 不就是一段文字嗎? 10/27 20:46
Lomonosov: 喔抱歉搞錯了 我以為是test的code 10/27 20:47
viper9709: 推一樓 10/27 23:13
leolarrel: 我覺得一樓還是不要太自信... 10/28 13:09
senjor: 大多時候的確都不需要寫註解,就好像大多時候都不需要加班 10/28 14:48
senjor: 然而大多數人還是會加班 XDDD 10/28 14:48
Ghamu: 沒用過 BDD test lib 但如果還要另外翻看的話還是寫註解比 10/28 20:19
Ghamu: 較好? 10/28 20:19