V2EX = way to explore
V2EX 是一个关于分享和探索的地方
Sign Up Now
For Existing Member  Sign In
• 请不要在回答技术问题时复制粘贴 AI 生成的内容
alpha4zeta
V2EX  ›  程序员

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

  •  
  •   alpha4zeta · Mar 18, 2019 via Android · 5814 views
    This topic created in 2600 days ago, the information mentioned may be changed or developed.
    36 replies    2019-03-18 18:55:02 +08:00
    binux
        1
    binux  
       Mar 18, 2019   ❤️ 17
    学会正确地提问,学会提正确的问题,对于现阶段的你比较重要。
    jiangnanyanyu
        2
    jiangnanyanyu  
       Mar 18, 2019 via Android
    老板会因为你会写代码给你薪水还是你会写文档给你薪水呢
    ericgui
        3
    ericgui  
       Mar 18, 2019
    如果是开源项目,个人觉得还是文档更重要
    LxExExl
        4
    LxExExl  
       Mar 18, 2019
    都重要
    singerll
        5
    singerll  
       Mar 18, 2019 via Android
    看啥文档了,ppt 和标书比代码重要的多
    alpha4zeta
        6
    alpha4zeta  
    OP
       Mar 18, 2019 via Android
    @binux 谢谢打脸,自己在做事情缺乏思考总结,所以提的问题很多时候都是没过大脑,这也是我每天会感到痛苦的点😰
    airfling
        7
    airfling  
       Mar 18, 2019
    最终是为谁服务的,谁给你的钱多,谁重要
    frankkai
        8
    frankkai  
       Mar 18, 2019
    没有可比性。
    chinese_zmm
        9
    chinese_zmm  
       Mar 18, 2019 via iPhone
    可以试试自文档技术,两者不矛盾
    rzti483NAJ66l669
        10
    rzti483NAJ66l669  
       Mar 18, 2019   ❤️ 3
    当然是写代码,
    情况是有些功能在写文档的时候自己都不知道如何实现的了。
    YanSep
        11
    YanSep  
       Mar 18, 2019 via Android
    文档是告诉别人和自己要干什么,代码则是具体怎么干。感觉这两个没有可比性呢
    alpha4zeta
        12
    alpha4zeta  
    OP
       Mar 18, 2019 via Android
    @Flobit 一个是结果一个是过程。看文档能看出你的逻辑思考和你会不会干活,间接反应你的能力,个人想法。唉😔带偏了
    yegle
        13
    yegle  
       Mar 18, 2019   ❤️ 3
    我给你介绍一下我们厂的职位的预期大致是怎么样的:
    L3:交给你的活能根据设计文档干完
    L4:能写设计文档给自己组里创造活
    L5:能写设计文档给自己和其他组创造活
    L6:能带领一个团队创造一个新产品(养活一个团队)

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

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

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

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

    怕就怕你一边想一边写甚至一边脑海里设计一边写,关键你又不是天才能一步到位啊,写到一半发现不行再回退,完了发现自己还不会利用版本控制,写一点提交一点,也没拉分支,跟别人的提交混在一起各种冲突,一回退把别人的也回退了,真的是灾难。
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Solana   ·   5118 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 146ms · UTC 08:15 · PVG 16:15 · LAX 01:15 · JFK 04:15
    ♥ Do have faith in what you're doing.