文档的作用与分类

1、文档的作用与分类软件文档document也称文件,通常指的是一些记录的数据和数据媒体,它具有固定不变的形式,可被人和计算机阅读.它和计算机程序共同构成了能完成特定功能的计算机软件有人把源程序也当作文档的一局部.我们知道,硬件产品和产品资料在整个生产过程中都是有形可见的,软件生产那么有很大不同,文档本身就是软件产品.没有文档的软件,不成其为软件,更谈不到软件产品.软件文档的编制documentation在软件开发工作中占有突出的地位和相当的工作量.高效率、高质量地开发、分发、治理和维护文档对于转让、变更、修正、扩充和使用文档,对于充分发挥软件产品的效益有着重要意义.然而,在实际工作中,文档在编制

2、和使用中存在着许多问题,有待于解决.软件开发人员中较普遍地存在着对编制文档不感兴趣的现象.从用户方面看,他们又常常抱怨：文档售价太高、文档不够完整、文档编写得不好、文档已经陈旧或是文档太多,难于使用等等.究竟应该怎样要求它,文档应该写哪些,说明什么问题,起什么作用？这里将给出简要的介绍.图1文档桥梁作用文档在软件开发人员、软件治理人员、维护人员、用户以及计算机之间的多种桥梁作用可从图1中看出.软件开发人员在各个阶段中以文档作为前阶段工作成果的表达和后阶段工作的依据,这个作用是显而易见的. 软件开发过程中软件开发人员需制定一些工作方案或工作报告,这些方案和报告都要提供应治理人员,并得到必要的支持

3、.治理人员那么可通过这些文档了解软件开发工程安排、 进度、资源使用和成果等. 软件开发人员需为用户了解软件 的使用、操作和维护提供详细的资料,我们称此为用户文档.以上三种文档构成了软件文档的主要局部.我们把这三种文档所包括的内容列在图2中.其中列举了十三个文档, 这里对 它们作一些简要说明:可行性研究报告：说明该软件开发工程的实现在技术上、 经济上和社会因素上的可行性, 评述为了合理地到达开发目标可供选择的各种可能实施的方案,说明并论证所选定实施方案的理由.工程开发方案：为软件工程实施方案制定出具体方案, 应该包括各局部工作的负责人员、 开发的进度、开发经费的预算、所需的硬件及软件资源等. 工

4、程开发方案应提供应治理部门, 并作为开发阶段评审的参考.软件需求说明书：也称软件规格说明书,其中对所开发软件的功能、性能、用户界面及运行环境等作出详细的说明. 它是用户与开发人员双方对软件需求取得共同理解根底上达 成的协议,也是实施开发工作的根底.数据要求说明书：该说明书应给出数据逻辑描述和数据采集的各项要求,为生成和维护 系统数据文卷作好准备.用户手册文档文档用户文档开发治理文档操作手册维护修改建议软件需求规格说明书软件需求规格说明书数据要求说明书概要设计说明书详细设计说明书可行性研究报告工程开发方案工程开发方案测试方案测试报告开发进度月报开发总结报告图2三种文档概要设计说明书：该说明书是概

5、要设计阶段的工作成果,它应说明功能分配、模块划分、程序的总体结构、输入输出以及接口设计、运行设计、数据结构设计和出错处理设计等,为 详细设计奠定根底.详细设计说明书：着重描述每一模块是怎样实现的,包括实现算法、逻辑流程等.用户手册：本手册详细描述软件的功能、 性能和用户界面,使用户了解如何使用该软件.操作手册：本手册为操作人员提供该软件各种运行情况的有关知识,特别是操作方法的具体细节.测试方案：为做好组装测试和确认测试,需为如何组织测试制定实施方案.方案应包括测试的内容、进度、条件、人员、测试用例的选取原那么、测试结果允许的偏差范围等.测试分析报告：测试工作完成以后, 应提交测试方案执行情况的

6、说明.对测试结果加以分析,并提出测试的结论意见.开发进度月报：该月报系软件人员按月向治理部门提交的工程进展情况报告.报告应包括进度方案与实际执行情况的比拟、阶段成果、遇到的问题和解决的方法以及下个月的打算等.工程开发总结报告：软件工程开发完成以后,应与工程实施方案对照,总结实际执行的情况,如进度、成果、资源利用、本钱和投入的人力.此外还需对开发工作作出评价,总 结出经验和教训.维护修改建议：软件产品投入运行以后,发现了需对其进行修正、更改等问题,应将存 在的问题、修改的考虑以及修改的影响估计作详细的描述,写成维护修改建议,提交审批.以上这些文档是在软件生存期中,随着各阶段工作的开展适时编制.其

7、中有的仅反映一个阶段的工作,有的那么需跨越多个阶段.表3给出了各个文档应在软件生存期中哪个阶段编 写.这些文档最终要向软件治理部门,或是向用户答复以下的问题：阶段文档可行性研究与方案需求分析设计代码编写测 试运行与维护可行性研究报 告工程开发方案软件需求说明数据要求说明概要设计说明详细设计说明测试方案用户手册操作手册测试分析报告开发进度月报工程开发总结维护修改建议表3软件生存期各阶段编制的文档哪些需求要被满足,即答复 做什么？所开发的软件在什么环境中实现以及所需信息从哪里来,即答复从何处？某些开发工作的时间如何安排,即答复何时干？某些开发或维护工作打算由 谁来干？某些需求是怎么实现的 ？为什么要进行那些软件开发或维护修改工作？上述十三个文档都在一定程度上答复了这六个方面的问题.这可从表4中看到.所提问题文档什 么何 处何 时谁如 何为 何可行性研究报告VV工程开发方案VV软件需求说明VV数据要求说明VV7概