常用注释关键字
| 注释名 | 语法 | 含义 |
|---|---|---|
| @function | @function 简要描述 | 用于定义当前对象是一个函数,后面可跟描述 |
| @description | @description 描述信息 | 用于描述 |
| @param | @param {参数类型} 参数名 - 描述信息 | 描述参数的信息 |
| @return | @return {返回类型} 描述信息 | 描述返回值的信息 |
| @author | @author 作者信息 [附属信息:如邮箱、日期] | 描述此函数作者的信息 |
| @version | @version XX.XX.XX | 描述此函数的版本号 |
| @example | @example 示例代码 | 演示函数的使用 |
/**
* @function 处理str
* @description 描述fn函数功能
* @param {String} st - 字符串
* @return {String}
* @author yanghui 2022/07/06
* @version 1.0.0
* @example
* fn(str)
*/
function fn(str) {
return str
}
4 条评论
实验数据可增加误差分析以提高严谨性。
建议多用口语化表达,拉近与读者距离。
这篇文章如同一首动人的乐章,触动了读者内心深处的柔软。
对话设计自然,符合角色身份与情境。