附2:软件文档编写向导文档分类项目包括如下几类文档:项目管理文档
包括:《软件项目计划》、《项目进度报告》、《项目开发总结报告》软件开发文档
包括:《需求规格说明》、《概要设计说明》、《详细设计说明》、《测试计划》、《软件测试分析报告》
包括:《用户操作手册》《演示文件》
软件项目计划(SoftwareProjectPlan)一.引言1.编写目的(阐明编写软件计划的目的,指出读者对象
)2.项目背景(可包括:(1)项目委托单位、开发单位和主管部门;(2)该软件系统与其他系统的关系
)3.定义(列出本文档中用到的专门术语的定义和缩略词的原文
)4.参考资料(可包括:文档所引用的资料、规范等;列出资料的作者、标题、编号、发表日期、出版单位或资料来源
)二.项目概述1
工作内容(简要说明项目的各项主要工作,介绍所开发软件的功能性能等
若不编写可行性研究报告,则应在本节给出较详细的介绍
条件与限制(阐明为完成项目应具备的条件开发单位已具备的条件以及尚需创造的条件
必要时还应说明用户及分合同承包者承担的工作完成期限及其它条件与限制
产品(1)程序(列出应交付的程序名称使用的语言及存储形式
)(2)文档(列出应交付的文档
)(3)运行环境(应包括硬件环境软件环境
)4.服务(阐明开发单位可向用户提供的服务
如人员培训安装保修维护和其他运行支持
)5.验收标准三.实施计划1.任务分解(任务的划分及各项任务的负责人
)2.进度(按阶段完成的项目,用图表说明开始时间完成时间
)3.预算4.关键问题(说明可能影响项目的关键问题,如设备条件技术难点或其他风险因素,并说明对策
)四.人员组织及分工五.交付期限六.专题计划要点(如测试计划等
)项目开发进度报告一.报告时间及所处的开发阶段二.给出进度1.本周的主要活动2.实际进展与计划比较三.所用工时(按不同层次人员分别计时