js 部分代码注释规范

普通注释

单行

// 单行注释,文字和//有一个空格

多行

    /*
      多行注释
      1.总是再多行注释的结束符前留一个空格,使星号对齐
      2.不要把注释写再多行注释的开始符，和结束符所在行
     */

文档注释

    /**
     *
     Core模块提供最基础、最核心的接口 (文档说明)
     *
     @module Core (文档名字)
     */

方法注释

    /**
     *
     方法说明
     *
     @method 方法名
     *
     @for 所属类名
     *
     @param {参数类型} [参数名 = 默认参数] 参数说明
     *
     @return {返回值类型} 返回值说明
     */