软件工程代码注释的艺术

1.Commenteachlevel(每个级别的注释有统一的风格)

注释每一个代码块,并且在各个级别的代码块上,要使用统一的注释方法。例如:

对于类,应包含简单的描述、作者以及最近的更改日期

对于方法,应包含目的的描述、功能、参数以及返回值

使用统一的注释规则对于一个团队是非常重要的。当然,更加推荐使用注释的约定和工具(例如,C#的XML或Java的Javadoc),它们会是注释变得更加容易。

2.Useparagraph







































白癜风症状图片
白癜风会传染



转载请注明:http://www.zjiaren.com/jbxx/4241.html