问下,大家做项目都是先写文档吗?写哪些文档? - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
Sign Up Now
For Existing Member  Sign In
请不要在回答技术问题时复制粘贴 AI 生成的内容
bayker

问下,大家做项目都是先写文档吗?写哪些文档?

  •  1
     
  •   bayker Jul 18, 2019 2940 views
    This topic created in 2474 days ago, the information mentioned may be changed or developed.

    一个新项目,在没有强制要求,验收要求的情况下,大家也会按软件开发方法先写各种文档吗?都写哪些文档?(外部系统访问的 API 接口文档除外)

    9 replies    2019-07-18 17:24:46 +08:00
    li27962278
        1
    li27962278  
       Jul 18, 2019
    现在项目要交接给另外的团队 自己负责的模块要写文档...

    要求是 :1.页面功能总述
    2.功能列表:列出页面的全部功能,每一个功能的作用是用做什么的。
    3.初始化页面逻辑,调用关系:描述所做功能的前后端关系图,内外部调用关系,前后端数据接口,后端的层级关系,数据库表格,时序图等。时序图关键步骤描述,根据时序图节点进行说明,写出代码位置。

    头大了...
    leon0903
        2
    leon0903  
       Jul 18, 2019
    不写,最多搞一个 swagger 文档。
    theoran
        3
    theoran  
       Jul 18, 2019
    理论上是先写文档后写代码
    实际上是先写代码后补文档。。。
    bayker
        4
    bayker  
    OP
       Jul 18, 2019
    @li27962278 如果你是接别人团队的项目,估计你也会这么要求别人这样写文档吧,哈哈。
    @leon0903 什么也不写的话后面怕出了什么疑问自己都得翻源码才行。
    @theoran 实际上确实是这样。
    leon0903
        5
    leon0903  
       Jul 18, 2019
    @bayker 代码写注释啊,关键性的代码写好注释就可以了。
    li27962278
        6
    li27962278  
       Jul 18, 2019
    @bayker

    我最多也就是代码写注释,文档确实是后面要求才写,不说的话自己不会主动写的 ;

    个人习惯在部署一个子系统或模块的时候会写一些流程给自己看
    Fule
        7
    Fule  
       Jul 18, 2019
    程序员最恨两件事:
    1. 写文档
    2. 别人的东西没有文档
    bayker
        8
    bayker  
    OP
       Jul 18, 2019
    @Fule 所以很矛盾,纠结啊
    gz911122
        9
    gz911122  
       Jul 18, 2019
    先写技术方案,因为要做技术评审.
    然后写 api 文档
    然后开搞
    About     Help     Advertise     Blog     API     FAQ     Solana     4890 Online   Highest 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 48ms UTC 01:09 PVG 09:09 LAX 18:09 JFK 21:09
    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