要写好简洁的代码,简洁的代码不需要注释。注释过多的程序说明程序很糟糕,需要过多的注释来解释。
注释不能美化糟糕的代码。
有些注释是必须的也是有利的。唯一真正好的做法是想办法不去写注释。
注释要有 提供信息,对意图的解释。或者警示性的注释。
注释可以用来放大某种看来不合理之物的重要性。
过程中注释是无畏之举,不要写多余注释,在方法开始注释说明方法用途便可,
不要写误导性注释。不要写过多的信息。写重点。
要写好简洁的代码,简洁的代码不需要注释。注释过多的程序说明程序很糟糕,需要过多的注释来解释。
注释不能美化糟糕的代码。
有些注释是必须的也是有利的。唯一真正好的做法是想办法不去写注释。
注释要有 提供信息,对意图的解释。或者警示性的注释。
注释可以用来放大某种看来不合理之物的重要性。
过程中注释是无畏之举,不要写多余注释,在方法开始注释说明方法用途便可,
不要写误导性注释。不要写过多的信息。写重点。