评论：良好的代码注释

来自：Ronald Alversado

Ronald Alversado — Sat, 30 Jan 2010 15:36:51 +0000

I will reccomend you to my collegues.

suny911 — Sun, 26 Apr 2009 15:33:21 +0000

我觉得楼上的方案不错，2套CSS，而且完全可以模拟JavaScript的处理方式，一套是完整开发加注释的 source，一套是通过程序处理过后的 pack，发布只用pack

丁宇 — Tue, 08 Jul 2008 01:48:47 +0000

我记得我在这里留言了，可至今未显示出来，还在审核吗？

丁宇 — Fri, 27 Jun 2008 06:48:34 +0000

html被过滤掉了，这个评论表单应该加个相应的提示。
上面提到的代码是：
link ref=”stylesheet” href=”css.php?file=style.css”

丁宇 — Fri, 27 Jun 2008 06:46:45 +0000

更好的做法是使用专门的注释方案，我一般用CSSDOC（目前恐怕也只有这个选择），写完了注释，使用parser可以把这些注释提取出来形成文档。

不过CSS算不上程序语言，难度和功能都有限，很多时候看文档还不如直接看代码 – 这点不比Java等编程语言。

如果担心增加流量，可以使用脚本输出css，在输出前将注释用正则过滤掉，比如：

或者干脆维护两套css，一套是带有注释的开发版本，一套是没有注释、空格、空行的生产版本。

mqycn — Sun, 08 Jun 2008 16:13:51 +0000

这样会不会垃圾代码太多了？

Luke — Sat, 07 Jun 2008 05:23:23 +0000

个人认为作者提到的给css加上一些维护性的注释非常非常的amazing。

但是也像作者说的，注释写多了也会带来很多垃圾代码（改的人多了的话也未必看得清楚）。特别想知道作者最后提到的归档整理是怎么个操作过程。