作者superpai (超級白)
看板Soft_Job
標題Re: [請益] 寫註解到底是不是好習慣
時間Sun Dec 30 09:17:28 2018
※ 引述《accessdenied (存取違規)》之銘言：
: 一個連別人的註解都不願維護的人（更糟者連自己的註解都不維護），你期望他修改別人
: 的function真的負起什麼修改的責任？function功用變了，他回去改function name 然後
: 把呼叫到這個function的所有程式碼都調整過？別傻了孩子！
改function name後 IDE 可以自動把其餘程式碼都自動調整
另外 function name 是 developer 自己寫程式時馬上就會用到的
好處馬上發生
跟註解是日後才會用到完全不同
: 連註解都懶惰不維護的會跟你搞refactoring？
大部分dev可以從refactoring獲得好處跟爽度
註解不會
所以維護註解需要不懶惰，但是搞refactoring 不用
要寫註解我也是完全同意
但是很明白的現實就是寫好註解是道德驅動
命名好function/變數是利益驅動
所以這個主題為什麼會戰？
因為從這項道德主體每個人的得到／損失不同
所以很多人都有相當有動力去弱化或強化他
--
※ 發信站: 批踢踢實業坊(ptt.cc), 來自: 61.68.64.240
※ 文章網址: https://webptt.com/m.aspx?n=bbs/Soft_Job/M.1546132651.A.EBA.html
1F：推 abcf: 自己寫的程式半年後來看都不一定完全看的懂，寫註解對自己 12/30 09:26
2F：→ abcf: 有利，對別人也有利，一樣都是利益驅動 12/30 09:26
3F：→ superpai: 如果要只要日後自己看得懂，我會精心設計變數跟function 12/30 09:33
4F：→ superpai: name 這樣在設計過程中我會很有成就感，又兼顧長期利益 12/30 09:33
5F：→ superpai: 說真的人很難去考慮長期利益啦，所以還是靠道德去維護 12/30 09:35
※ 編輯: superpai (61.68.64.240), 12/30/2018 09:37:48
6F：→ robler: 這兩件事有衝突嗎 你可以同時做阿 12/30 12:18
7F：噓 darkMood: 道德個屁啊，職業精神啦 12/30 14:29
8F：→ darkMood: 註解就是有無法取代的地方，其他不用扯那麼遠 12/30 14:30
9F：→ babelism: ...註解是道德驅動這種說法...你是不是誤解了道德的意思 12/30 22:28
10F：→ viper9709: 一樓正解 01/03 22:45