倡议-帖上的程序加上清晰明了的注释和好编程风格-支持的顶下

小飞爱使申华

30%好像太多，一般在每个function的开头解释一下功能，再加上令人费解的地方点一下，最多加上定义变量注释一下，满打满算10%已到头了。

hoxide

是啊是啊
我的程序很少写注释的 不过~~~过后还读得懂 主要是命名很重要 我的命名一向so长

flw

换言之，注释到底应该有多少？以能够让另外的同事/同行看懂为标准，不需要让小学生都能看懂。

蓝色键盘

如果要读别人的应用程序，那么了解程序的逻辑和流程便足够把握程序了。

为此，对于应用级别的程序，关键的一些逻辑转化，特殊含义的标识或者函数、甚至标识符的命名都需要注释一下。注释没有什么必须的限制，每个公司的做法都不一致。

蓝色键盘

如果是系统程序。那么注释是很有讲究的。

morning_leaf

注释一定要，但是关键地方，一般人不容易理解，或者只看代码很难反应过来的地方；
特殊的算法，特殊的技巧使用的地方

我们的程序不是写给不会程序的人看的，也不是写给一般算法都不会的人看的；
只是在一般书本要求，大家都已经习惯外的地方写注释；

dintan

我們公司的要求注釋為5%

yufeng8552

看来以后我要减少注释了

shusl

我赞同蓝色键盘兄观点!在一个较大的系统工程开发中,从分析到程序实现以及维护都需要很好的日志文件档案和注释.我觉的这些文档对于一个系统的开发成功与否占据很重要的位置!