注释写得太多了会挨打吗？

[fundebug]

[whypool]

会，把注释当文档了

[pain400]

挺好的

[orange1818]

我已经备好手枪了

[easylee]

一份经久不衰的代码，注释量与代码量的比应该至少为 2:1。

[fundebug]

@orange1818 《刑法》第一百二十八条第一款的罪名为非法持有、私藏枪支、弹药罪。该款规定：违反枪支管理规定，非法持有、私藏枪支、弹药的，处三年以下有期徒刑、拘役或者管制；情节严重的，处三年以上七年以下有期徒刑。

[smilepig]

详细点是蛮好的。。。

[wupher]

别的都还好，console.warn 我笑了

[Mariano]

随便看了一眼，密密麻麻的字看的我头疼

[yulitian888]

不写注释才会被打呢
比如下面这样的：

/*

+---------------+
| |
| 本数据库操作类 |
| |
+--+--+---------+
| ^
v |
|
+-----+---------+
| |
| 数据库 |
| |
| |
+---------------+



*/

[ranoff]

个人觉得的有点多

[zhangjiabin1010]

喜闻乐见啊，多写点注释，方便你我他

[yangxiongguo]

导出一下就是文档了啊

[kios]

写多了我不知道，写少了可能会被同事强杀

[keinx]

有个同事写的注释特别有意思，注释里面带了很多段子，有时候找 BUG 找的心烦，看到他的诡异注释还是挺不错的。

[depress]

我要是接手一个项目注释这么详细，我会请那个人吃顿饭，而且这个注释好在是在代码块外，如果是代码中，注释比代码还多，影响阅读代码那体验就很糟了。

[mztql]

规规整整的多好啊

[janxin]

没有 fuck，表明这段注释和代码是一个人写的 XD

[HuHui]

工作严重不饱和

[SamsonWang]

注释详细点挺好的

[maichael]

jsdoc 的话，选填属性应该这么写

```
@param {string} [somebody] - Somebody's name.
```