各位大佬说说写文档重要还是写代码重要

2019-03-18 07:22:28 +08:00
 alpha4zeta
4976 次点击
所在节点    程序员
36 条回复
boris1993
2019-03-18 10:01:04 +08:00
底层码农表示
看见差的代码,我会骂操你妈那个傻逼写的狗屎让老子擦屁股
遇到没有文档,我会骂操你妈什么傻逼项目连个文档都他妈没有老子拿吊写啊
所以,都重要。写的好不好直接决定会不会被骂。
litp
2019-03-18 10:08:09 +08:00
手 和 脚 哪个更重要?
vindurriel
2019-03-18 10:12:59 +08:00
文档是写给产品 销售 测试看的 写好了就不用你一遍一遍解释了 代码则是你写给自己和未来的开发维护者的文档
crist
2019-03-18 10:18:37 +08:00
写 PPT 比较重要一点。
xpresslink
2019-03-18 10:23:21 +08:00
如果脱离具体场景问这个问题没有什么意义。
项目赶工文档都是扯淡了,互联网的很多项目,今天上线明天就可能下线,需求模块被砍也是分分钟的事儿,所以从务实的角度说都是等真正上线了以后需求和功能非常稳定了,有空闲时间了再补文档,不然就白做大量无用功。
代码写得好通常会更重要一些,命名非常具体贴切,结构清晰,再加必要的注释,根本不需要文档。现在还有一种方式就是文档直接写在代码中,由文档生成工具来出文档。当然了扯这些有点远了。
kneep
2019-03-18 10:51:36 +08:00
最好能做到代码即文档
index90
2019-03-18 10:53:22 +08:00
楼主想问该往哪个方向发展?
继续当 Coder,还是往项目?架构?解决方案?发展
fire9
2019-03-18 11:48:49 +08:00
写代码重要,但是没有代码的文档就是一坨屎.
yuanshixoong
2019-03-18 12:18:45 +08:00
就像问食物和水哪个重要一样
liu19931020
2019-03-18 12:53:03 +08:00
我觉得,文档写的好,代码就写的好;代码写得好,不一定文档写得好
MiffyLiye
2019-03-18 12:56:05 +08:00
逆向工作法,先写新闻稿、用户手册,后写代码
keepcleargas
2019-03-18 13:03:26 +08:00
都重要 软件工程专业毕业的 一般文档 写得都比较漂亮的。计算机专业毕业的 代码估计写得好些。
af463419014
2019-03-18 13:17:28 +08:00
代码 -> 实物
文档 -> 实物的外观或味道

缺少文档的代码 = 屎味的冰淇淋
缺少代码的文档 = 冰淇淋味的屎

请问你想吃哪个?
fakeshadow
2019-03-18 13:45:13 +08:00
没人吐槽文档的时候代码重要。
suyuyu
2019-03-18 14:21:25 +08:00
要是问我大哥肯定说是一样重要
shmilypeter
2019-03-18 18:55:02 +08:00
如果思路理清楚再写,写代码就是纯粹的体力劳动了,而设计文档和 UML 图只是理清思路的副产品而已。

怕就怕你一边想一边写甚至一边脑海里设计一边写,关键你又不是天才能一步到位啊,写到一半发现不行再回退,完了发现自己还不会利用版本控制,写一点提交一点,也没拉分支,跟别人的提交混在一起各种冲突,一回退把别人的也回退了,真的是灾难。

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

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

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

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

© 2021 V2EX