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

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

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

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

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

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

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

    怕就怕你一边想一边写甚至一边脑海里设计一边写,关键你又不是天才能一步到位啊,写到一半发现不行再回退,完了发现自己还不会利用版本控制,写一点提交一点,也没拉分支,跟别人的提交混在一起各种冲突,一回退把别人的也回退了,真的是灾难。
    关于   ·   FAQ   ·   API   ·   我们的愿景   ·   广告投放   ·   感谢   ·   实用小工具   ·   1593 人在线   最高记录 5168   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.3 · 36ms · UTC 01:55 · PVG 09:55 · LAX 17:55 · JFK 20:55
    ♥ Do have faith in what you're doing.