Re: [請益] 寫註解到底是不是好習慣

作者: superpai (超級白)   2018-12-30 09:17:28
※ 引述《accessdenied (存取違規)》之銘言:
: 一個連別人的註解都不願維護的人(更糟者連自己的註解都不維護),你期望他修改別人
: 的function真的負起什麼修改的責任?function功用變了,他回去改function name 然後
: 把呼叫到這個function的所有程式碼都調整過?別傻了孩子!
改function name後 IDE 可以自動把其餘程式碼都自動調整
另外 function name 是 developer 自己寫程式時馬上就會用到的
好處馬上發生
跟註解是日後才會用到完全不同
: 連註解都懶惰不維護的會跟你搞refactoring?
大部分dev可以從refactoring獲得好處跟爽度
註解不會
所以維護註解需要不懶惰,但是搞refactoring 不用
要寫註解我也是完全同意
但是很明白的現實就是寫好註解是道德驅動
命名好function/變數是利益驅動
所以這個主題為什麼會戰?
因為從這項道德主體每個人的得到/損失不同
所以很多人都有相當有動力去弱化或強化他
作者: abcf (悠哉悠哉的魚)   2018-12-30 09:26:00
自己寫的程式半年後來看都不一定完全看的懂,寫註解對自己有利,對別人也有利,一樣都是利益驅動
作者: superpai (超級白)   2018-12-30 09:33:00
如果要只要日後自己看得懂,我會精心設計變數跟functionname 這樣在設計過程中我會很有成就感,又兼顧長期利益說真的人很難去考慮長期利益啦,所以還是靠道德去維護
作者: robler (章魚丸)   2018-12-30 12:18:00
這兩件事有衝突嗎 你可以同時做阿
作者: darkMood (瞬間投射)   2018-12-30 14:29:00
道德個屁啊,職業精神啦註解就是有無法取代的地方,其他不用扯那麼遠
作者: babelism (Bob)   2018-12-30 22:28:00
...註解是道德驅動這種說法...你是不是誤解了道德的意思
作者: viper9709 (阿達)   2017-01-03 22:45:00
一樓正解

Links booklink

Contact Us: admin [ a t ] ucptt.com