让那些无用代码注释见鬼去

时间:2022-09-12 11:36:21
【文件属性】:

文件名称:让那些无用代码注释见鬼去

文件大小:2KB

文件格式:RAR

更新时间:2022-09-12 11:36:21

资讯

本文是html5tricks原创翻译,转载请看清文末的转载要求,谢谢合作! 摘要——注释简单代码会干扰对重要注释的理解。程序开发者最好能用最精要的注释来解释重点代码。 举个例子,你打开一个电箱,里面有几百根电线,蒙了吧。再一看,每根电线上面都有一个整洁的小标签。真是谢天谢地啊!但是,当你一个个去翻看标签的时候,见鬼的,几乎所有的标签都是空白的! 然后,在你花了整整一个小时去浏览每一个小标签之后,终于给你找到12条有用的信息,真心喜大普奔!当然,希望在你头脑一片混乱的时候得出的结果仍然是正确的,没有遗漏,呵呵呵。 当我需要研究代码的时候看到到处都是垃圾注释,唉,我的感觉就和上面在那么多标签里面找有用的一样。见鬼的,想从一大堆垃圾注释里确定哪个有用简直就像大海捞针! 说一个常用的开源项目,里面都是这些垃圾注释: /** * __construct function. * * @access public * @return void */ public function __construct() { … } 再来一个: /**[......] 阅读全文>>


【文件预览】:
html5-canvas-line-chart
----css()
--------style.css(889B)
----js()
--------index.js(1KB)
----index.html(599B)

网友评论