• 请不要在回答技术问题时复制粘贴 AI 生成的内容
alpha4zeta
V2EX  ›  程序员

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

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

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

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

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

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

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