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

大佬

文档

代码

说说

36 条回复 • 2019-03-18 18:55:02 +08:00

1

binux

2019-03-18 07:29:57 +08:00

17

学会正确地提问，学会提正确的问题，对于现阶段的你比较重要。

2

jiangnanyanyu

2019-03-18 07:36:02 +08:00 via Android

老板会因为你会写代码给你薪水还是你会写文档给你薪水呢

3

ericgui

2019-03-18 07:45:57 +08:00

如果是开源项目，个人觉得还是文档更重要

4

LxExExl

2019-03-18 07:50:03 +08:00

都重要

5

singerll

2019-03-18 07:54:14 +08:00 via Android

看啥文档了，ppt 和标书比代码重要的多

6

alpha4zeta

OP

2019-03-18 08:14:53 +08:00 via Android

@binux 谢谢打脸，自己在做事情缺乏思考总结，所以提的问题很多时候都是没过大脑，这也是我每天会感到痛苦的点😰

7

airfling

2019-03-18 08:22:17 +08:00

最终是为谁服务的，谁给你的钱多，谁重要

8

frankkai

2019-03-18 08:29:28 +08:00

没有可比性。

9

chinese_zmm

2019-03-18 08:32:05 +08:00 via iPhone

可以试试自文档技术，两者不矛盾

10

Humorce

2019-03-18 08:32:54 +08:00

3

当然是写代码，
情况是有些功能在写文档的时候自己都不知道如何实现的了。

11

Flobit

2019-03-18 08:44:26 +08:00 via Android

文档是告诉别人和自己要干什么，代码则是具体怎么干。感觉这两个没有可比性呢

12

alpha4zeta

OP

2019-03-18 08:47:24 +08:00 via Android

@Flobit 一个是结果一个是过程。看文档能看出你的逻辑思考和你会不会干活，间接反应你的能力，个人想法。唉😔带偏了

13

yegle

2019-03-18 08:55:53 +08:00

3

我给你介绍一下我们厂的职位的预期大致是怎么样的：
L3：交给你的活能根据设计文档干完
L4：能写设计文档给自己组里创造活
L5：能写设计文档给自己和其他组创造活
L6：能带领一个团队创造一个新产品（养活一个团队）

要不要写文档，写文档重要还是写代码重要，取决于你在哪个 level

14

yiyi11

2019-03-18 09:08:53 +08:00 via Android

写业务实现代码在整个软件生命周期占比只是一小部分。

15

jackchao7432

2019-03-18 09:10:37 +08:00

@ericgui 那也是在代码重要的前提下，一个烂项目要那么好的文档干啥？

16

Flobit

2019-03-18 09:20:15 +08:00 via Android

@alpha4zeta 文档写得好，不见得编码会差，PPT 就算了哈

17

cdlixucd

2019-03-18 09:24:46 +08:00

向前（ money ）看

18

reus

2019-03-18 09:28:22 +08:00

代码要写，文档也要写
你问哪个重要，是不是觉得写了代码就可以不写文档？或者写了文档就不用写代码？

19

taaaang

2019-03-18 09:31:51 +08:00

两码事儿

20

SuperMild

2019-03-18 09:51:31 +08:00 via iPhone

这个问题相当于问老婆重要还是妈妈重要，没事找事，根本不是谁更重要的问题。

小平同志的务实哲学还是很有意义的，别跟我瞎扯什么重要浪费时间，我就一句话：两手抓，两手都要硬。

21

boris1993

2019-03-18 10:01:04 +08:00 via Android

底层码农表示
看见差的代码，我会骂操你妈那个傻逼写的狗屎让老子擦屁股
遇到没有文档，我会骂操你妈什么傻逼项目连个文档都他妈没有老子拿吊写啊
所以，都重要。写的好不好直接决定会不会被骂。

22

litp

2019-03-18 10:08:09 +08:00

1

手和脚哪个更重要？

23

vindurriel

2019-03-18 10:12:59 +08:00 via iPhone

文档是写给产品销售测试看的写好了就不用你一遍一遍解释了代码则是你写给自己和未来的开发维护者的文档

24

crist

2019-03-18 10:18:37 +08:00

写 PPT 比较重要一点。

25

xpresslink

2019-03-18 10:23:21 +08:00

如果脱离具体场景问这个问题没有什么意义。
项目赶工文档都是扯淡了，互联网的很多项目，今天上线明天就可能下线，需求模块被砍也是分分钟的事儿，所以从务实的角度说都是等真正上线了以后需求和功能非常稳定了，有空闲时间了再补文档，不然就白做大量无用功。
代码写得好通常会更重要一些，命名非常具体贴切，结构清晰，再加必要的注释，根本不需要文档。现在还有一种方式就是文档直接写在代码中，由文档生成工具来出文档。当然了扯这些有点远了。

26

kneep

2019-03-18 10:51:36 +08:00 via iPhone

最好能做到代码即文档

27

index90

2019-03-18 10:53:22 +08:00

楼主想问该往哪个方向发展？
继续当 Coder，还是往项目？架构？解决方案？发展

28

fire9

2019-03-18 11:48:49 +08:00

写代码重要,但是没有代码的文档就是一坨屎.

29

yuanshixoong

2019-03-18 12:18:45 +08:00 via Android

就像问食物和水哪个重要一样

30

liu19931020

2019-03-18 12:53:03 +08:00

我觉得，文档写的好，代码就写的好；代码写得好，不一定文档写得好

31

MiffyLiye

2019-03-18 12:56:05 +08:00

逆向工作法，先写新闻稿、用户手册，后写代码

32

keepcleargas

2019-03-18 13:03:26 +08:00

都重要软件工程专业毕业的一般文档写得都比较漂亮的。计算机专业毕业的代码估计写得好些。

33

af463419014

2019-03-18 13:17:28 +08:00

代码 -> 实物
文档 -> 实物的外观或味道

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

请问你想吃哪个?

34

fakeshadow

2019-03-18 13:45:13 +08:00

没人吐槽文档的时候代码重要。

35

suyuyu

2019-03-18 14:21:25 +08:00

要是问我大哥肯定说是一样重要

36

shmilypeter

2019-03-18 18:55:02 +08:00

如果思路理清楚再写，写代码就是纯粹的体力劳动了，而设计文档和 UML 图只是理清思路的副产品而已。

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