为什么要写软件文档?
软件开发人员需要了解用户的需求,并根据用户及开发人员一致的理解编写文档,为下一工作提供材料;参与软件开发的人员会在各个阶段以文档作为这一阶段的成果总结并且为下一阶段提供了重要的依据,方便下一个阶段工作的展开;而与此同时管理人员可以通过这些文档来了解项目的开发情况;软件文档的存在方便了软件维护人员熟悉该软件,进行维护工作。软件文档的存在提高了软件开发的效率。
每个阶段文档有哪些?
定义阶段:可行性研究报告,软件需求说明书
开发阶段:概要设计说明书,详细设计说明书,数据库设计说明书,数据要求说明书
测试阶段:测试说明书、测试分析说明书
运行及维护阶段:操作手册
用户使用:用户手册
各文档之间有哪些区别?
文档名称 | 编写目的 | 编写人员 | 预期读者 |
可行性研究报告 | 软件开发是否可行,从经济、社会、影响因素等方面分析 | 开发人员 | 管理人员 |
项目开发计划 | 制定各个阶段的任务及时间规定 | 管理人员 | 开发人员 |
软件需求说明书 | 从功能、性能等方面分析软件的需求,结合用户来分析 | 开发人员、用户 | 开发人员 |
概要设计说明书 | 系统的整体结构 | 开发人员 | 管理人员、开发人员 |
详细设计说明书 | 将结构模块化,分析各个模块的类、接口及其接口之间的联系,逻辑结构、算法 | 开发人员 | 开发人员、测试人员、维护人员 |
数据库设计说明书 | 所使用数据库的结构,各个表之间的联系,窗体与数据库之间的联系 | 开发人员 | 开发人员、测试人员、维护人员 |
数据要求说明书 | 分析数据的流程,类型,对涉及的数据进行规定 | 开发人员 | 开发人员、测试人员、维护人员 |
测试计划 | 根据功能、性能、兼容性等制定测试计划,选择合适的测试方法 | 开发人员 | 测试人员 |
测试分析报告 | 对测试的结果进行分析,并提出改进的建议 | 测试人员 | 开发人员、维护人员 |
项目开发总结报告 | 对这个开发的过程进行总结,明确每个阶段的完成情况 | 开发人员 | 管理人员 |
操作手册 | 软件的使用详细指导,方便对系统进行操作 | 开发人员 | 维护人员 |
用户手册 | 从用户的角度介绍整个软件从安装到日常维护等操作 | 开发人员 | 用户 |
开发进度月报 | 及时反馈项目的进度,处理开发过程中出现的问题 | 开发人员 | 管理人员、开发人员 |