学生党在做小学期,又到了写文档的时候。
每次最烦的就是写文档,感觉完全破坏了写代码那种畅爽的感觉。
请问各位程序员在工作中也经常写文档吗?还是交给专人维护?
1
ihuotui 2017-07-07 18:50:25 +08:00 via iPhone
不会写文档程序员不是好 ceo
|
2
jswh 2017-07-07 18:55:46 +08:00
是一种技能,我做的不好,但我觉得技多不压身。
|
3
tolerance 2017-07-07 19:07:39 +08:00
代码就是最好的文档
|
4
mokeyjay 2017-07-07 19:11:11 +08:00 via Android
按照一定的规范写好注释,然后就能用生成器生成文档了
|
5
qiqico 2017-07-07 19:11:16 +08:00
不觉得文档写得好的代码更好看吗?去看下一些优秀的开源代码~
有时候会通过写注释来整理思路,然后根据注释框架填充代码 |
6
libook 2017-07-07 19:19:21 +08:00
代码是给人看的,顺便给程序执行而已。
我写 JS,所以会用 JSDoc 和 URIDoc 格式来用注释写文档,看代码及文档。 你若代码极其清晰,一眼就看懂,可以不写注释或文档。 我达不到这种程度,一边写代码一边写注释,之后还会时不时补充注释,基本上注释量和代码量一样多。 |
7
zhuangtongfa 2017-07-07 19:20:48 +08:00 via Android
文档比单元测试还重要
|
8
sagaxu 2017-07-07 19:37:08 +08:00 via Android
跟前端或者 APP 对接的时候会写个文档,其它一般不写文档,也不写注释,只在几个比较关键的点,解释一下为什么这么做。
|
9
visonme 2017-07-07 20:00:17 +08:00
写和说是基本技能,也是关键技能
|
10
littleylv 2017-07-07 20:41:41 +08:00
讨厌两种事:
0、写文档 1、别人不写文档 (逃 |
11
xmumiffy 2017-07-07 20:58:16 +08:00 via Android
写文档多好啊
|
12
cxbig 2017-07-07 21:09:56 +08:00
当然要写,不然几个月后自己都不知道它是干嘛的了。
要不是有 Git Blame 做证,我都没办法相信自己一个月前写的代码有多烂。 |
13
wshcdr 2017-07-08 10:36:38 +08:00
自动生成文档啊
|