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

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

  •  
  •   liuguangxuan · Jan 8, 2023 · 4053 views
    This topic created in 1401 days ago, the information mentioned may be changed or developed.

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

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

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


    要写文档
    wu67
    wu67
    Jan 8, 2023
    3
    只有在上家接了国企的外包时才需要写.
    另外如果给时间, 写也不是不行, 最烦的就压缩工期要你写文档, 写文档的时间不允许写进文档...
    leyfung
    leyfung
    Jan 8, 2023
    4
    概要设计、详细设计
    815979670
    815979670
    Jan 8, 2023
    5
    我们开始只是要求写文档,后来我用多余的实际 在文档的基础上再加上流程图 让整个逻辑看起来更清晰
    hhjswf
    hhjswf
    Jan 8, 2023 via Android
    6
    要啊,项目验收的时候客户会要文档
    yolee599
    yolee599
    Jan 8, 2023 via Android
    7
    让产品经理写,需求都是他出的他最清楚
    gowk
    gowk
    Jan 8, 2023
    8
    想问下大家这样的文档你们团队一般保存在哪里?用什么工具
    moonrailgun
    moonrailgun
    PRO
    Jan 8, 2023
    9
    产品经理要写,开发要写,QA 要写。
    FranzKafka95
    FranzKafka95
    Jan 8, 2023 via Android
    10
    详细设计文档你总要写吧
    hiugo
    hiugo
    Jan 9, 2023
    11
    @gowk confluence
    iovekkk
    iovekkk
    Jan 9, 2023
    12
    会,纳入了季度考核指标
    而且还 TM 非常蛋疼的是先写代码后写文档
    其实也就是为了流程补文档
    不过好处就是可以瞎写,只要内容丰满即可
    7911364440
    7911364440
    Jan 9, 2023
    13
    接口文档+设计文档
    zhanlanhuizhang
    zhanlanhuizhang
    Jan 9, 2023
    14
    1 ,非常不喜欢先写代码,后补文档。(感觉对自己就是坑)
    2 ,遇到业务复杂的中大型项目,不写文档,我已经体验过了。业务型 bug ,满天飞各个模块之间的调用好多问题。
    yaphets666
    yaphets666
    Jan 9, 2023
    15
    写呗,反正按时间算钱,加班写就算了。
    yc8332
    yc8332
    Jan 9, 2023
    16
    不写。。就写接口文档。。做业务的谁写那个啊。。难道是给人外包做系统吗
    wangerka
    wangerka
    Jan 9, 2023
    17
    OP 和层里说的都是后端吧,前端很少要求写文档
    exonuclease
    exonuclease
    Jan 9, 2023
    18
    有一堆 design doc troubleshooting guide 还有各种接口 or 工具的文档 好在活不多有空写
    allgy
    allgy
    Jan 9, 2023
    19
    只写 API 文档,其他的一律免谈
    gausszhou
    gausszhou
    Jan 10, 2023
    20
    可信变革...
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Privacy   ·   Solana   ·   4275 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 83ms · UTC 07:38 · PVG 15:38 · LAX 23:38 · JFK 02:38
    ♥ Do have faith in what you're doing.