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

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

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

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

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

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

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

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