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

想听听大家对写开发文档或者设计文档的看法

  •  1
     
  •   cong · 2019-09-03 19:35:14 +08:00 · 3102 次点击
    这是一个创建于 1909 天前的主题,其中的信息可能已经有所发展或是发生改变。

    没经历过大公司,平时写复杂逻辑会画一些简单的图。想听听大家对写开发文档或者设计文档的看法。

    13 条回复    2019-09-05 11:08:19 +08:00
    xuanbg
        1
    xuanbg  
       2019-09-03 19:57:27 +08:00
    我司要什么文档我说了算,所以。。。。。。

    流程图(BPMN 多泳道流程)、业务分析图(脑图)、建表 SQL 脚本、接口文档(README.MD)、资源配置表(脑图)就是全部。

    其实最重要的文档就是代码本身呀
    ebingtel
        2
    ebingtel  
       2019-09-03 20:10:00 +08:00
    能保证别人知道你要干嘛就行 格式不必拘泥 关键路径落到纸上会好些……然后才去看你的代码
    sumarker
        3
    sumarker  
       2019-09-03 20:14:15 +08:00
    没写过设计文档
    开发文档一般就是找个地方画一画看看
    securityCoding
        4
    securityCoding  
       2019-09-03 20:26:00 +08:00
    1.模块图
    2.关键流程时序图
    3.接口文档,导出 swagger json 文件,导入到 yapi 平台
    4.排期
    iConnect
        5
    iConnect  
       2019-09-03 20:30:01 +08:00 via Android
    文档还没写完,由于需求变更,代码已经重写啦
    FrankHB
        6
    FrankHB  
       2019-09-03 20:54:25 +08:00
    最有效的是 coding convention 之类具有强制约束力的文件。
    其它的,就写给自己会用的才用心。
    hoyixi
        7
    hoyixi  
       2019-09-03 21:05:46 +08:00
    其实,设计文档没出来,根本不该开发,你开发啥?照着什么开发?尤其规模大的项目,没有好的需求文档和设计文档,就是一坨翔

    当然领导不会这么想,反正让下面人加班就行了,996 搞起来
    nianyu
        8
    nianyu  
       2019-09-03 21:36:18 +08:00
    国内别想了,都是走形式
    Takamine
        9
    Takamine  
       2019-09-03 22:35:31 +08:00
    ER 图,时序图,接口文档,设计方案业务分析。
    Leigg
        10
    Leigg  
       2019-09-03 23:22:25 +08:00 via Android
    如果想走的更远,必须约会画图,除非你牛鼻到需要时脑中自然成图。团队开发时,图和文档尤其重要
    cong
        11
    cong  
    OP
       2019-09-04 10:51:26 +08:00
    不知道大公司是怎么做的,有大公司经历能不能说一下啊
    Aresxue
        12
    Aresxue  
       2019-09-04 14:16:29 +08:00
    作为开发人员,平时主要涉及的设计文档基本上是功能的详细设计和概要设计,对于它们的态度我认为是必须要有,工期紧也要先有概设,后期再补详设。但是在实际过程中不写文档的人比比皆是,但这是有问题的。正规的开发流程是先写概设然后找业务人员确认,然后写详设,叫上开发组长评审,最终把详设中的设计付诸代码,你管不了别人但你可以约束自己。
    DoctorCat
        13
    DoctorCat  
       2019-09-05 11:08:19 +08:00
    代码不要屎一样,结合基本的业务设计文档和注释,还是可以应对的。
    代码屎一样,结合基本的业务设计文档和注释,还是很难应对的。
    至于设计文档与代码实现之间的关系,很容易因为开发同学或者 PM 同学的尽责程度变成一种玄学过程。

    文档说明白、更新的及时,怎么个形式都好说。关键在于文档的维护。见过太多文档对不上业务实现的案例了。
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   1128 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 42ms · UTC 18:19 · PVG 02:19 · LAX 10:19 · JFK 13:19
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.