作者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/cn.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