美文网首页
服务端开发技术文档要包含什么?

服务端开发技术文档要包含什么?

作者: 魏小小伊 | 来源:发表于2020-01-09 18:31 被阅读0次

    【写在前面:为什么整理这个,因为我们很多开发写的技术文档真的是,,,所以希望日后随手提供开发一个自己需要的文档格式,培养写技术文档的能力,增进合作效率】

    一、需求背景
    1、需求文档链接
    2、简要说明业务背景
    3、需求范围(明确此次需求涉及的模块等)

    二、流程图
    1、技术角度流程图

    三、数据库
    1、表结构设计
    2、表关联关系说明

    四、接口概览
    1、接口描述(请求入口截图或者别的)
    2、接口链接(URL)
    3、请求方式
    4、请求参数
    5、请求参数示例(格式)
    6、返回数据
    7、返回数据示例(格式)
    8、接口间关联关系
    9、数据字典:例如参数值是数字的,在这一部分说明数字对应什么
    10、返回值code码说明

    五、测试帮助文档
    1、增删改查接口(附带入参&返回等)
    2、测试方法(有影响线上展示的情况提供)
    3、影响范围

    ——————————————————————————————————————————
    20200217补充:
    六、公共细节提醒
    1、系统核心设计点
    2、系统调用依赖(上下游&对接人)
    3、本次迭代对现有系统影响
    4、测试分析(重点、容易遗漏的测试点)

    ——————————————————————————————————————————
    20200327补充:
    七、其他说明
    1、ABtest
    2、版本兼容(兼容历史版本)
    3、术语解释(需求新起的名称做说明,避免太多种名称)

    八、FAQ

    九、附录

    相关文章

      网友评论

          本文标题:服务端开发技术文档要包含什么?

          本文链接:https://www.haomeiwen.com/subject/yvquactx.html