文件注释 文件注释位于文件的最前面，应包括文件的以下信息：概要说明及版本（必须）项目地址（开源组件必须）版权声明（必须）开源协议（开源组件必须）版本号（必须）修改时间（必须），以ISO格式表示（可使用Sublime Text的InsertDate插件插入）文件注释必须全部以英文字符表示 ...

题引： 　　作为专业的js开发工程师，注释规范与否至关重要，下面推荐一下个人总结的javascript注释模板，采用jsDoc规范； 正文： 　　在一个文件中注释大概分三类：文档注释、函数（类）注释、（变量）常量注释 　　文档注释：告知他人该js文件主要处理的核心内容； 　　函数（类 ...

代码注释是架起程序设计者与程序阅读者之间的通信桥梁，最大限度的提高团队开发合作效率。也是程序代码可维护性的重要环节之一。所以我们不是为写注释而写注释。下面说一下我们在诉求网二期开发中使用的代码注释规范，供大家参考下。 原则： 1、注释形式统一 在整个应用程序中，使用具有一致的标点和结构的样式 ...

1.Doxygen简介 Doxygen是一个程序的文档产生工具，可以将程序中的注释转换成说明文档或者说是API参考手册，从而减少程序员整理文档的时间。当然这里程序中的注释需要遵循一定的规则书写，才能让Doxygen识别和转化。 目前Doxygen可处理的程序语言包含C/C++、Java ...

注释形式统一 在整个解决方案中，使用一致的标点和结构的样式来构造注释，是架起团队成员沟通的桥梁既可以提高程序开发效率，也可以保证程序的可维护性。但是请不要试图使用这个标准来破坏旧解决方案的注释规范。一个解决方案的规范标准一致性才是最重 ...

//收集了一小部分，忘记的时候过来查一下 java--hadoop部分 <P>是单独起个段落 （注意和<br>换行、<pre>再起一个段落 比较 ...

java代码注释规范 一、规范存在的意义 应用编码规范对于软件本身和软件开发人员而言尤为重要，有以下几个原因： 1、好的编码规范可以尽可能的减少一个软件的维护成本 , 并且几乎没有任何一个软件，在其整个生命周期中，均由最初的开发人员来维护； 2、好的编码规范 ...

有人说，代码即注释，也就是通过你的代码就能看得懂你的代码逻辑是什么。但是对于大多数人来说，这有些不切实际，每个公司的研发团队成员的能力是不一样的，有的能力强，有的能力弱，能力强的体现在能解决若干问题，但是在编码规范方面却有待提高，能力弱的，有的能力弱的在代码规范方面却比所谓的能力强的要好 ...