写文档比写代码难多了

2020-09-04 16:52:46 +08:00
 heboy

最近计划开源一个项目，功能很简单总共就 3 个命令加一些扩展，结果文档写了两个月还是不满意，删了写写了删。真的比写代码还纠结

1949 次点击
所在节点    问与答
16 条回复
wysnylc
2020-09-04 16:56:09 +08:00
文字的历史比代码可久多了
rimutuyuan
2020-09-04 16:57:12 +08:00
写文档还好，写解决方案才费劲，想起了被 800 字支配的恐惧
redbuck
2020-09-04 17:02:42 +08:00
找下有没有自动生成的方案.
iMiata
2020-09-04 17:05:40 +08:00
上家公司基本所有项目的文档基本都是我给补齐的，亲身体会是写文档用英文比中文简单
heboy
2020-09-04 17:07:06 +08:00
@iMiata 哈哈我也觉得，英文的反而好写，可能是我英文词汇量少不用纠结
shifttacn
2020-09-04 17:10:28 +08:00
工作内容一大部分是看别人的代码，然后写文档。
看别人代码才是最难的。
iMiata
2020-09-04 17:10:42 +08:00
其实主要是编程整个一套知识体系都是舶来品，用英文描述相对比中文更准确（也是水平还不够，没法用中文准确描述哈哈）
raaaaaar
2020-09-04 17:11:34 +08:00
看什么文档吧，复杂点的程序，如果文档没写好，程序质量也不会太高。
wangkun025
2020-09-04 17:28:33 +08:00
代码也是英文的，所以……
iConnect
2020-09-04 17:40:10 +08:00
有些复杂度高的代码，100 行不到，半天看不明白也很常见
IGJacklove
2020-09-04 17:43:27 +08:00
文档先写个大概的被，有问题可以等别人 pr 或根据具体问题补充
cassyfar
2020-09-04 17:43:48 +08:00
一个好的代码，不需要文档，因为他有自述性（狗头
hoyixi
2020-09-04 17:58:46 +08:00
你这是使用文档吧，设计文档更显技术，好的设计文档，放在那里，拉几个人立刻就能重新做出来
heboy
2020-09-04 18:25:41 +08:00
@hoyixi 没错，是使用文档😅
wzzzx
2020-09-04 19:29:14 +08:00
我也觉得文档难写，说人话是真的好难
Cielsky
2020-09-04 19:59:58 +08:00
@wzzzx 说人话确实难哈哈

这是一个专为移动设备优化的页面（即为了让你能够在 Google 搜索结果里秒开这个页面），如果你希望参与 V2EX 社区的讨论，你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/704273

V2EX 是创意工作者们的社区，是一个分享自己正在做的有趣事物、交流想法，可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX