码迷,mamicode.com
首页 > 其他好文 > 详细

代码注释规范

时间:2018-07-25 19:04:57      阅读:160      评论:0      收藏:0      [点我收藏+]

标签:let   继承   cto   修改   too   tool   manager   正文   相关   

规范说明:

  1. 关键字用[]括起来
  2. 关键字和标题之间用一个空格
  3. 标题不要使用句号结尾
  4. 标题不超过50个字符。
  5. 正文与标题另外起换行。
  6. 正文解释是什么和为什么,而不是如何做。

关键字:

  • [add] 新增
  • [update] 修改
  • [delete] 删除
  • [fix] 修复
  • [doc] 文档
  • [style] 格式
  • [refactor] 重构
  • [test] 增加测试
  • [tool] 工具相关

例子:

  1. [add] 开放平台验证接口
  2. [update] Token类实现修改为使用子类继承
    支援多种Token调用
  3. [delete] Timer类
    已经被TimerManager替换
  4. [fix] 验证码短信文字乱码问题
  5. [doc] README.rd

代码注释规范

标签:let   继承   cto   修改   too   tool   manager   正文   相关   

原文地址:https://www.cnblogs.com/mrblue/p/9367623.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!