昨天对一批代码文件进行了清理。大哥汝吃饱了没事干?吾在进行某一工作之前,都会进行此类操作。这也是吾推荐给其他人的做法。内容有:
- 加@Override
- 降低访问关系,如去掉public。
- 删除无用代码。
- 去掉注释。
有朋友看到第四项会觉得奇怪,大家不都是鼓励、要求写注释吗?汝怎么还删除?因为注释都是没人维护的,或者本身就含糊甚至错误,留着没有好处反而有坏处。
每个公司都鼓吹注释重要、有用,实际上呢?并没有安排写注释的时间。所以,注释不是工作的一部分。所以:
- 注释程序员免费赠送给公司的,同样也可以不赠送。如果代码变化了,肯定不维护,注释跟着就没用了甚至错了。
- 其他程序员碰到注释,也不会去看内容。为什么呢?注释本身就不清楚,看也看不明白,即使觉得明白了也不一定对。
- 公司也没拿注释当回事,又没有奖励、又没有审核(审核是不可能的,一辈子都不可能的)。
作为管理人员,应该怎样正确要求注释?