這邊怎麼老是吵著小孩子頭上有幾根毛的問題。
說不用註解的,都是英雄主義作祟,自己因為自己的程式碼天下最簡潔易懂,這種看不清
自己的人還挺多的。
團隊合作就是要註解,除非你不在乎團隊!
你以為大家都是你肚子裡的蛔蟲?
我光是寫一行code:
key = salt + DateTime.Now.AddHours(-4).ToString(“MMdd”);
就會一直有人來問為什麼要這樣寫,-4什麼意思?
最後我加上一行註解從此耳根清淨
// 廠商要求每天清晨4點以後要更換加密金鑰
大家講了半天,註解只有一個缺點,就是過時美人維護。而我認為這才是真正該教育改善
的文化和心態:不是我寫的註解,所以我沒有維護的責任。
這才是真正的弊端,而不是倡導clean code。
一個連別人的註解都不願維護的人(更糟者連自己的註解都不維護),你期望他修改別人
的function真的負起什麼修改的責任?function功用變了,他回去改function name 然後
把呼叫到這個function的所有程式碼都調整過?別傻了孩子!
連註解都懶惰不維護的會跟你搞refactoring?
用不寫註解來解決註解過時或錯誤的問題,根本「掩耳盜鈴」嘛!
更何況註解帶來的利益,用遇到幾個誤解的註解,就想要全盤否定,根本以偏概全。
還有一種註解我也常寫,我這邊的解決手法參考到什麼google 解答,我會把blog or sta
ckoverflow 的連結放在註解內,讓後人知道這個解法的思路怎麼來。
團隊戰不是給這些自命清高不寫註解的小孩子們玩的!