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