最近计划开源一个项目,功能很简单总共就 3 个命令加一些扩展,结果文档写了两个月还是不满意,删了写写了删。真的比写代码还纠结
1
wysnylc 2020-09-04 16:56:09 +08:00
文字的历史比代码可久多了
|
2
rimutuyuan 2020-09-04 16:57:12 +08:00
写文档还好,写解决方案才费劲,想起了被 800 字支配的恐惧
|
3
redbuck 2020-09-04 17:02:42 +08:00
找下有没有自动生成的方案.
|
4
iMiata 2020-09-04 17:05:40 +08:00
上家公司基本所有项目的文档基本都是我给补齐的,亲身体会是写文档用英文比中文简单
|
6
shifttacn 2020-09-04 17:10:28 +08:00
工作内容一大部分是看别人的代码,然后写文档。
看别人代码才是最难的。 |
7
iMiata 2020-09-04 17:10:42 +08:00
其实主要是编程整个一套知识体系都是舶来品,用英文描述相对比中文更准确(也是水平还不够,没法用中文准确描述哈哈)
|
8
raaaaaar 2020-09-04 17:11:34 +08:00 via Android
看什么文档吧,复杂点的程序,如果文档没写好,程序质量也不会太高。
|
9
wangkun025 2020-09-04 17:28:33 +08:00
代码也是英文的,所以……
|
10
iConnect 2020-09-04 17:40:10 +08:00 via Android
有些复杂度高的代码,100 行不到,半天看不明白也很常见
|
11
IGJacklove 2020-09-04 17:43:27 +08:00 via Android
文档先写个大概的被,有问题可以等别人 pr 或根据具体问题补充
|
12
cassyfar 2020-09-04 17:43:48 +08:00
一个好的代码,不需要文档,因为他有自述性(狗头
|
13
hoyixi 2020-09-04 17:58:46 +08:00
你这是使用文档吧,设计文档更显技术,好的设计文档,放在那里,拉几个人立刻就能重新做出来
|
15
wzzzx 2020-09-04 19:29:14 +08:00
|