统计帖,请问各位开发的老哥,公司会要求你们写文档吗? - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
请不要在回答技术问题时复制粘贴 AI 生成的内容
liuguangxuan
V2EX    程序员

统计帖,请问各位开发的老哥,公司会要求你们写文档吗?

  •  
  •   liuguangxuan 2023-01-08 20:14:05 +08:00 3388 次点击
    这是一个创建于 1031 天前的主题,其中的信息可能已经有所发展或是发生改变。

    最近项目做完了,被公司要求写各种文档,动辄十几个文档,而且要求配各种图(组成图、架构图、流程图等等)。被整的头都大了。

    有点儿好奇其它公司是什么样子的。所以想问一下各位老哥:

    1. 你们公司会要求开发写文档吗?
    2. 分别有哪些文档?
    3. 写文档占开发的时间比?
    20 条回复    2023-01-10 00:50:29 +08:00
    ysicing
        1
    ysicing  
       2023-01-08 20:19:43 +08:00
    需要写
    看需求大小,大需求,写设计方案,数据库结构(DBA 评审),API 文档,测试用例
    cydysm
        2
    cydysm  
       2023-01-08 20:21:33 +08:00 via iPhone
    我最讨厌两种人了
    1 、不写文档的人
    2 、让我写文档的人


    要写文档
    wu67
        3
    wu67  
       2023-01-08 20:55:12 +08:00
    只有在上家接了国企的外包时才需要写.
    另外如果给时间, 写也不是不行, 最烦的就压缩工期要你写文档, 写文档的时间不允许写进文档...
    leyfung
        4
    leyfung  
       2023-01-08 21:04:16 +08:00
    概要设计、详细设计
    815979670
        5
    815979670  
       2023-01-08 21:04:19 +08:00
    我们开始只是要求写文档,后来我用多余的实际 在文档的基础上再加上流程图 让整个逻辑看起来更清晰
    hhjswf
        6
    hhjswf  
       2023-01-08 21:28:37 +08:00 via Android
    要啊,项目验收的时候客户会要文档
    yolee599
        7
    yolee599  
       2023-01-08 21:29:33 +08:00 via Android
    让产品经理写,需求都是他出的他最清楚
    gowk
        8
    gowk  
       2023-01-08 22:21:59 +08:00
    想问下大家这样的文档你们团队一般保存在哪里?用什么工具
    moonrailgun
        9
    moonrailgun  
       2023-01-08 22:34:03 +08:00
    产品经理要写,开发要写,QA 要写。
    FranzKafka95
        10
    FranzKafka95  
       2023-01-08 23:10:31 +08:00 via Android
    详细设计文档你总要写吧
    hiugo
        11
    hiugo  
       2023-01-09 06:40:53 +08:00
    @gowk confluence
    iovekkk
        12
    iovekkk  
       2023-01-09 09:08:52 +08:00
    会,纳入了季度考核指标
    而且还 TM 非常蛋疼的是先写代码后写文档
    其实也就是为了流程补文档
    不过好处就是可以瞎写,只要内容丰满即可
    7911364440
        13
    7911364440  
       2023-01-09 09:47:36 +08:00
    接口文档+设计文档
    zhanlanhuizhang
        14
    zhanlanhuizhang  
       2023-01-09 09:47:38 +08:00
    1 ,非常不喜欢先写代码,后补文档。(感觉对自己就是坑)
    2 ,遇到业务复杂的中大型项目,不写文档,我已经体验过了。业务型 bug ,满天飞各个模块之间的调用好多问题。
    yaphets666
        15
    yaphets666  
       2023-01-09 09:56:07 +08:00
    写呗,反正按时间算钱,加班写就算了。
    yc8332
        16
    yc8332  
       2023-01-09 09:58:42 +08:00
    不写。。就写接口文档。。做业务的谁写那个啊。。难道是给人外包做系统吗
    wangerka
        17
    wangerka  
       2023-01-09 14:25:21 +08:00
    OP 和层里说的都是后端吧,前端很少要求写文档
    exonuclease
        18
    exonuclease  
       2023-01-09 14:28:53 +08:00
    有一堆 design doc troubleshooting guide 还有各种接口 or 工具的文档 好在活不多有空写
    allgy
        19
    allgy  
       2023-01-09 16:45:43 +08:00
    只写 API 文档,其他的一律免谈
    gausszhou
        20
    gausszhou  
       2023-01-10 00:50:29 +08:00
    可信变革...
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     1050 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 27ms UTC 18:30 PVG 02:30 LAX 10:30 JFK 13:30
    Do have faith in what you're doing.
    ubao msn snddm index pchome yahoo rakuten mypaper meadowduck bidyahoo youbao zxmzxm asda bnvcg cvbfg dfscv mmhjk xxddc yybgb zznbn ccubao uaitu acv GXCV ET GDG YH FG BCVB FJFH CBRE CBC GDG ET54 WRWR RWER WREW WRWER RWER SDG EW SF DSFSF fbbs ubao fhd dfg ewr dg df ewwr ewwr et ruyut utut dfg fgd gdfgt etg dfgt dfgd ert4 gd fgg wr 235 wer3 we vsdf sdf gdf ert xcv sdf rwer hfd dfg cvb rwf afb dfh jgh bmn lgh rty gfds cxv xcv xcs vdas fdf fgd cv sdf tert sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf shasha9178 shasha9178 shasha9178 shasha9178 shasha9178 liflif2 liflif2 liflif2 liflif2 liflif2 liblib3 liblib3 liblib3 liblib3 liblib3 zhazha444 zhazha444 zhazha444 zhazha444 zhazha444 dende5 dende denden denden2 denden21 fenfen9 fenf619 fen619 fenfe9 fe619 sdf sdf sdf sdf sdf zhazh90 zhazh0 zhaa50 zha90 zh590 zho zhoz zhozh zhozho zhozho2 lislis lls95 lili95 lils5 liss9 sdf0ty987 sdft876 sdft9876 sdf09876 sd0t9876 sdf0ty98 sdf0976 sdf0ty986 sdf0ty96 sdf0t76 sdf0876 df0ty98 sf0t876 sd0ty76 sdy76 sdf76 sdf0t76 sdf0ty9 sdf0ty98 sdf0ty987 sdf0ty98 sdf6676 sdf876 sd876 sd876 sdf6 sdf6 sdf9876 sdf0t sdf06 sdf0ty9776 sdf0ty9776 sdf0ty76 sdf8876 sdf0t sd6 sdf06 s688876 sd688 sdf86