平时写文档的文档要求
开发文档分级要求
一级要求:
- 列举项目中使用到的技术栈,以及对应的版本。如 Swift4, python3等。
- 列举项目中使用到的第三方库,以及对应的版本。如Jquery3.5.1等。
- 列举项目中交互的的类库以及相关的开发人员。 如Gavin (webservice)。
- 绘制项目的业务逻辑流程图。
- 绘制项目中主要功能描述图及相关功能简介。
- 建立Git远程仓或本地仓,方便追踪历史改动。
二级要求:
- 列举项目中主要提供及使用的接口,并作出分类解释。
- 描述交互的类库使用及注意事项,包括调用的流程。
- 提供项目使用调试的开发环境的说明文档,方便进一步运行测试。
- 提供项目历史的编译版本,以及版本更改说明。
- 提供项目中重大改动事件,如bug,需求。
三级要求:
- 使用工具生成代码拓扑表,并描述接口相关信息。
- 列举项目中未完成功能(TODO)及优化方案。
- 重点描述项目中核心模块代码,包含流程,调用,测试,解释。
【推荐】国内首个AI IDE,深度理解中文开发场景,立即下载体验Trae
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 记一次.NET内存居高不下排查解决与启示
· 探究高空视频全景AR技术的实现原理
· 理解Rust引用及其生命周期标识(上)
· 浏览器原生「磁吸」效果!Anchor Positioning 锚点定位神器解析
· 没有源码,如何修改代码逻辑?
· 全程不用写代码,我用AI程序员写了一个飞机大战
· DeepSeek 开源周回顾「GitHub 热点速览」
· MongoDB 8.0这个新功能碉堡了,比商业数据库还牛
· 记一次.NET内存居高不下排查解决与启示
· 白话解读 Dapr 1.15:你的「微服务管家」又秀新绝活了