第四与十七章读书笔记
第四章:两人合作
原文:4.2.9 注释
问题:我看到这一章的时候就很好奇企业对代码注释的要求,想现网上的意见有很大的分歧,有人说自己公司要求尽量少些代码,有的则对注释所占的先去了解一下,慢慢改变自己注释的风格便于以后工作,然后发篇幅有具体的要求,比如注释不得低于代码量的40%,下面是我挑选的几段有意思的评论:
1.我们公司代码没有注释的,有也只是 极少部分的 英文注释。
对此我问了主程,他告诉我几个原因。
第一,属性,方法,类的命名全部都有规律,能看懂英文就知道这个属性干嘛的,绝对不会是那些什么 String a1 = "身份证号码";List<String> gglist = null; 莫名其妙之类的。
第二,代码整洁美观,有注释会显得很乱。这是他个人见解,代码洁癖吧。
第三,如果有些地方要用注释,也要用英文,考虑到有中文注释的项目导入别的工程环境里面会乱码。虽然说可以重新调整工程环境,但是如果英文看的懂的话,何必用中文。
有时候我用中文注释 还会被他一脸嫌弃....
2.一般来说,我们的注释,要么是使用文档,要么是告诉你为什么要这么设计。
而且好的设计都是没有注释的,因为一个合格的工程师当然要理解好的设计为什么好。我们只注释那些设计不好但是又不得不这么做的。
当然了,这并不是什么好事,大家不要学。我相信大部分公司都不敢因为一个程序员看不懂代码就开除(逃)
3.之前公司专门有同事写注释的.....没错,你没看错,除了写注释他不干别的。
4.不写注释扣你一半工资,自己看着办。
而且在我看到的评论里面,发现不写注释的要比写注释的多,然后我就很迷惑,我们是应该注重注释,还是让自己成为别人说的“避免写注释的优秀程序员”,其实我自己查了半天资料,心里也没有一个明确的答案,但感觉自己要偏向避免写写注释一点的。
第十七章:人,绩效和职业道德
原文:17.4 萝卜与白菜
问题:你希望团队里白菜多还是萝卜多?
想法:我个人觉得团队里还是白菜多一点好,因为我觉得在项目开始前每个人的分工,应该负责的工作应该都是已经合理分配好的,大牛分配的工作量多一些,普通员工少一点,没问题,那么你最起码应该先把自己的那部分工作做好,无论你帮助了多少人,但你自己的工作没做好的话,那就是你的失职,不应该用“功”来掩饰自己的“过”,我们应该奖励在做好自己本职工作之后去帮助同伴的人,但绝不是不是“不洗泥的萝卜”。