各位大佬说说写文档重要还是写代码重要 - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
请不要在回答技术问题时复制粘贴 AI 生成的内容
alpha4zeta
V2EX    程序员

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

  •  
  •   alpha4zeta 2019-03-18 07:22:28 +08:00 via Android 534 次点击
    这是一个创建于 2406 天前的主题,其中的信息可能已经有所发展或是发生改变。
    36 条回复    2019-03-18 18:55:02 +08:00
    binux
        1
    binux  
       2019-03-18 07:29:57 +08:00   17
    学会正确地提问,学会提正确的问题,对于现阶段的你比较重要。
    jiangnanyanyu
        2
    jiangnanyanyu  
       2019-03-18 07:36:02 +08:00 via Android
    老板会因为你会写代码给你薪水还是你会写文档给你薪水呢
    ericgui
        3
    ericgui  
       2019-03-18 07:45:57 +08:00
    如果是开源项目,个人觉得还是文档更重要
    LxExExl
        4
    LxExExl  
       2019-03-18 07:50:03 +08:00
    都重要
    singerll
        5
    singerll  
       2019-03-18 07:54:14 +08:00 via Android
    看啥文档了,ppt 和标书比代码重要的多
    alpha4zeta
        6
    alpha4zeta  
    OP
       2019-03-18 08:14:53 +08:00 via Android
    @binux 谢谢打脸,自己在做事情缺乏思考总结,所以提的问题很多时候都是没过大脑,这也是我每天会感到痛苦的点
    airfling
        7
    airfling  
       2019-03-18 08:22:17 +08:00
    最终是为谁服务的,谁给你的钱多,谁重要
    frankkai
        8
    frankkai  
       2019-03-18 08:29:28 +08:00
    没有可比性。
    chinese_zmm
        9
    chinese_zmm  
       2019-03-18 08:32:05 +08:00 via iPhone
    可以试试自文档技术,两者不矛盾
    rzti483NAJ66l669
        10
    rzti483NAJ66l669  
       2019-03-18 08:32:54 +08:00   3
    当然是写代码,
    情况是有些功能在写文档的时候自己都不知道如何实现的了。
    YanSep
        11
    YanSep  
       2019-03-18 08:44:26 +08:00 via Android
    文档是告诉别人和自己要干什么,代码则是具体怎么干。感觉这两个没有可比性呢
    alpha4zeta
        12
    alpha4zeta  
    OP
       2019-03-18 08:47:24 +08:00 via Android
    @Flobit 一个是结果一个是过程。看文档能看出你的逻辑思考和你会不会干活,间接反应你的能力,个人想法。唉带偏了
    yegle
        13
    yegle  
       2019-03-18 08:55:53 +08:00   3
    我给你介绍一下我们厂的职位的预期大致是怎么样的:
    L3:交给你的活能根据设计文档干完
    L4:能写设计文档给自己组里创造活
    L5:能写设计文档给自己和其他组创造活
    L6:能带领一个团队创造一个新产品(养活一个团队)

    要不要写文档,写文档重要还是写代码重要,取决于你在哪个 level
    yiyi11
        14
    yiyi11  
       2019-03-18 09:08:53 +08:00 via Android
    写业务实现代码在整个软件生命周期占比只是一小部分。
    jackchao7432
        15
    jackchao7432  
       2019-03-18 09:10:37 +08:00
    @ericgui 那也是在代码重要的前提下,一个烂项目要那么好的文档干啥?
    YanSep
        16
    YanSep  
       2019-03-18 09:20:15 +08:00 via Android
    @alpha4zeta 文档写得好,不见得编码会差,PPT 就算了哈
    cdlixucd
        17
    cdlixucd  
       2019-03-18 09:24:46 +08:00
    向前( money )看
    reus
        18
    reus  
       2019-03-18 09:28:22 +08:00
    代码要写,文档也要写
    你问哪个重要,是不是觉得写了代码就可以不写文档?或者写了文档就不用写代码?
    taaaang
        19
    taaaang  
       2019-03-18 09:31:51 +08:00
    两码事儿
    SuperMild
        20
    SuperMild  
       2019-03-18 09:51:31 +08:00 via iPhone
    这个问题相当于问老婆重要还是妈妈重要,没事找事,根本不是谁更重要的问题。

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

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

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

    怕就怕你一边想一边写甚至一边脑海里设计一边写,关键你又不是天才能一步到位啊,写到一半发现不行再回退,完了发现自己还不会利用版本控制,写一点提交一点,也没拉分支,跟别人的提交混在一起各种冲突,一回退把别人的也回退了,真的是灾难。
    关于     帮助文档     自助推广系统   span class="snow">   博客     API     FAQ     Solana     2686 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 26ms UTC 14:18 PVG 22:18 LAX 07:18 JFK 10:18
    Do have faith in what you're doing.
    ubao msn snddm index pchome yahoo rakuten mypaper meadowduck bidyahoo youbao zxmzxm asda bnvcg cvbfg dfscv mmhjk xxddc yybgb zznbn ccubao uaitu acv GXCV ET GDG YH FG BCVB FJFH CBRE CBC GDG ET54 WRWR RWER WREW WRWER RWER SDG EW SF DSFSF fbbs ubao fhd dfg ewr dg df ewwr ewwr et ruyut utut dfg fgd gdfgt etg dfgt dfgd ert4 gd fgg wr 235 wer3 we vsdf sdf gdf ert xcv sdf rwer hfd dfg cvb rwf afb dfh jgh bmn lgh rty gfds cxv xcv xcs vdas fdf fgd cv sdf tert sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf shasha9178 shasha9178 shasha9178 shasha9178 shasha9178 liflif2 liflif2 liflif2 liflif2 liflif2 liblib3 liblib3 liblib3 liblib3 liblib3 zhazha444 zhazha444 zhazha444 zhazha444 zhazha444 dende5 dende denden denden2 denden21 fenfen9 fenf619 fen619 fenfe9 fe619 sdf sdf sdf sdf sdf zhazh90 zhazh0 zhaa50 zha90 zh590 zho zhoz zhozh zhozho zhozho2 lislis lls95 lili95 lils5 liss9 sdf0ty987 sdft876 sdft9876 sdf09876 sd0t9876 sdf0ty98 sdf0976 sdf0ty986 sdf0ty96 sdf0t76 sdf0876 df0ty98 sf0t876 sd0ty76 sdy76 sdf76 sdf0t76 sdf0ty9 sdf0ty98 sdf0ty987 sdf0ty98 sdf6676 sdf876 sd876 sd876 sdf6 sdf6 sdf9876 sdf0t sdf06 sdf0ty9776 sdf0ty9776 sdf0ty76 sdf8876 sdf0t sd6 sdf06 s688876 sd688 sdf86