请问各位是怎么看待写文档的？

[helica]

学生党在做小学期，又到了写文档的时候。

每次最烦的就是写文档，感觉完全破坏了写代码那种畅爽的感觉。

请问各位程序员在工作中也经常写文档吗？还是交给专人维护？

[ihuotui]

不会写文档程序员不是好 ceo

[jswh]

是一种技能，我做的不好，但我觉得技多不压身。

[tolerance]

代码就是最好的文档

[mokeyjay]

按照一定的规范写好注释，然后就能用生成器生成文档了

[qiqico]

不觉得文档写得好的代码更好看吗？去看下一些优秀的开源代码~

有时候会通过写注释来整理思路，然后根据注释框架填充代码

[libook]

代码是给人看的，顺便给程序执行而已。
我写 JS，所以会用 JSDoc 和 URIDoc 格式来用注释写文档，看代码及文档。
你若代码极其清晰，一眼就看懂，可以不写注释或文档。
我达不到这种程度，一边写代码一边写注释，之后还会时不时补充注释，基本上注释量和代码量一样多。

[zhuangtongfa]

文档比单元测试还重要

[sagaxu]

跟前端或者 APP 对接的时候会写个文档，其它一般不写文档，也不写注释，只在几个比较关键的点，解释一下为什么这么做。

[visonme]

写和说是基本技能，也是关键技能

[U7Q5tLAex2FI0o0g]

讨厌两种事：
0、写文档
1、别人不写文档
（逃

[106npo]

写文档多好啊

[cxbig]

当然要写，不然几个月后自己都不知道它是干嘛的了。
要不是有 Git Blame 做证，我都没办法相信自己一个月前写的代码有多烂。

[wshcdr]

自动生成文档啊