软件开发文档规范方案.docVIP

-.

.word.zl

附2:

软件文档编写向导

文档分类

工程包括如下几类文档：

工程管理文档。包括：?软件工程方案?、?工程进度报告?、?工程开发总结报告?

软件开发文档。包括：?需求规格说明?、?概要设计说明?、?详细设计说明?、?测试方案?、?软件测试分析报告?。

产品文档。包括：?用户操作手册??演示文件?。

软件工程方案

〔SoftwareProjectPlan〕

?一．引言

1．编写目的〔说明编写软件方案的目的，指出读者对象。〕

2．工程背景〔可包括：〔1〕工程委托单位、开发单位和主管部门；〔2〕该软件系统与其他系统的关系。〕

3．定义〔列出本文档中用到的专门术语的定义和缩略词的原文。〕

4．参考资料〔可包括：文档所引用的资料、规等；列出资料的作者、标题、编号、发表日期、出版单位或资料来源。〕

二．工程概述

1.???工作容〔简要说明工程的各项主要工作,介绍所开发软件的功能性能等.假设不编写可行性研究报告,那么应在本节给出较详细的介绍。)

2.???条件与限制〔说明为完成工程应具备的条件开发单位已具备的条件以及尚需创造的条件.必要时还应说明用户及分合同承包者承当的工作完成期限及其它条件与限制。〕

3.???产品

??〔1〕程序〔列出应交付的程序名称使用的语言及存储形式。〕

????〔2〕文档〔列出应交付的文档。〕

????〔3〕运行环境〔应包括硬件环境软件环境。〕

4．效劳〔说明开发单位可向用户提供的效劳.如人员培训安装保修维护和其他运行支持。〕

5．验收标准

三．实施方案

1．任务分解〔任务的划分及各项任务的负责人。〕

2．进度〔按阶段完成的工程,用图表说明开场时间完成时间。〕

3．预算

4．关键问题〔说明可能影响工程的关键问题,如设备条件技术难点或其他风险因素,并说明对策。〕

四．人员组织及分工

五．交付期限

六．专题方案要点〔如测试方案等。〕

工程开发进度报告?

一．报告时间及所处的开发阶段

二．给出进度

1．?本周的主要活动

2．?实际进展与方案比拟

三．所用工时〔按不同层次人员分别计时。〕

四．所有机时

五．工作遇到的问题及采取的对策

六．本周完成的成果

七．下周的工作方案

八．特殊问题

工程开发总结报告?

一．引言

1．编写目的〔说明编写总结报告的目的,指明读者对象。〕

2．工程背景〔说明工程的来源、委托单位、开发单位及主管部门。〕

3．定义〔列出报告中用到的专门术语定义和缩写词的原意。〕

4．参考资料〔列出这些资料的作者、标题、编号、发表日期、出版单位或资料来源，可包括：〔1〕工程开发方案；〔2〕需求规格说明书；〔3〕概要设计说明书；〔4〕详细设计说明书；〔5〕用户操作手册；〔6〕测试方案；〔7〕测试分析报告〔8〕本报告引用的其他资料、采用的开发标准或开发规。〕

二．开发结果

1．?产品〔可包括：〔1〕列出各局部的程序名称、源程序行数〔包括注释行〕或目标程序字节数及程序总计数量、存储形式；产品文档名称等。〕

2．?主要功能及性能

3．?所用工时〔按人员的不同层次分别计时。〕

4．?所用机时

5．?进度〔给出方案进度与实际进度的比照。〕

三．评价

1．生产率评价〔如平均每人每周源程序行数、文档的字数等。〕

2．技术方案评价

3．产品质量评价

四．经历与教训?

需求规格说明书

〔RequirementsSpecification〕?

一．引言

1．?编写目的〔说明编写需求说明书的目的,指明读者对象。〕

2．?工程背景〔可包括：〔1〕工程的委托单位,开发单位和主管部门；〔2〕该软件系统与其他系统的关系。〕

3．?定义〔列出文档中用到的专门术语定义和缩写词的原文。〕

4．?参考资料〔可包括：〔1〕工程开发方案；〔2〕文档所引用的资料，标准和规。列出这些资料的作者、标题、编号、发表日期、出版单位或资料来源。〕

二．任务概述

1．目标

2．运行环境

3．条件与限制

三．数据描述

1．?静态数据

2．?动态数据〔包括输入数据和输出数据。〕

3．?数据库描述〔给出使用数据库的名称和类型。〕

4．?数据词典

5．?数据采集

四．功能需求

1．功能划分

2．功能描述

五．性能需求

1．数据准确度

2．时间特性〔如响应时间、更新处理时间、数据转化与传输时间、运行时间等。〕

3．适应性〔在操作方式运行环境与其他软件的接口以及开发方案等发生变化时，应具有的适应能