V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
alpha4zeta
V2EX  ›  程序员

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

  •  
  •   alpha4zeta · 2019-03-18 07:22:28 +08:00 via Android · 5174 次点击
    这是一个创建于 2085 天前的主题,其中的信息可能已经有所发展或是发生改变。
    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
    可以试试自文档技术,两者不矛盾
    Humorce
        10
    Humorce  
       2019-03-18 08:32:54 +08:00   ❤️ 3
    当然是写代码,
    情况是有些功能在写文档的时候自己都不知道如何实现的了。
    Flobit
        11
    Flobit  
       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 那也是在代码重要的前提下,一个烂项目要那么好的文档干啥?
    Flobit
        16
    Flobit  
       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
    手 和 脚 哪个更重要?
    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 图只是理清思路的副产品而已。

    怕就怕你一边想一边写甚至一边脑海里设计一边写,关键你又不是天才能一步到位啊,写到一半发现不行再回退,完了发现自己还不会利用版本控制,写一点提交一点,也没拉分支,跟别人的提交混在一起各种冲突,一回退把别人的也回退了,真的是灾难。
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   2726 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 26ms · UTC 09:25 · PVG 17:25 · LAX 01:25 · JFK 04:25
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.