中间产品文档的价值-软件工程专业导论

图4-11中各个阶段的工作成果(或称提交物),也称为中间产品,代表的是各阶段的劳动成果,例如概要设计阶段产生的《概要设计文档》,编码阶段产生的《源代码和代码卷宗》,测试阶段的测试计划、测试用例和测试结果分析等。中间产品是十分重要的,从工程角度来看:

(1)中间产品质量是最终产品质量的依据。在软件的开发过程中,如果能够“第一次就做对”,即所有活动输出的中间产品都是正确的。那么,最终产品当然也就没有错误,就是正确或零缺陷的。

然而,对于软件开发来讲,很难做到“第一次就做对”。解决的办法是在每个阶段活动后进行评审,尽可能找出该阶段工作中的错误。“尽可能”就意味着不能够完全消除该阶段的错误。其原因在于,当前阶段所产生错误可能要等到后期的一些阶段才能被发现,而不是当前阶段结束时的评审就能发现。中间产品的缺陷越多,最终产品质量也会越差。

(2)中间产品可以提高工作的复用程度。一个软件生产企业内部、多个企业之间、客户等的要求、以及系统的运行维护和升级改造,都需要对以前的工作成果进行复用。

一个项目的需求、设计、实现、测试文档和方法,以及项目的工作流程可以作为下一个项目的参考。阶段性工作产品被相互参考和复用,正像机械和建筑图纸一样,需求文档、软件设计文档和方案可以被复用,代码可以被复用,测试用例和测试过程也可以被复用。(www.xing528.com)

当一个大客户或一个客户群体,例如国防部门,能够对软件系统的建设提出总体框架时,就能够分解出来许多共性软件作为部件,交给一些特定的开发商开发。这种共性软件部件,包括其开发文档就能被其他软件项目复用。例如,数据库管理系统(DBMS),实际上是人们在软件项目中,提出的对共性部件的需求驱动开发出通用的数据管理系统(参见6.3.1节)。

(3)中间产品可以极大地降低返工工作量。如果没有中间产品,一旦发现错误,就必须全部返工——回到需求分析阶段,因为开发队伍搞不清缺陷是哪个阶段引入的。这样的返工工作量是巨大的。特别是,在人员流动的情况下,更无法追溯缺陷发生的根源。有了中间产品,仅需要查找当前的中间产品,或者仅返回到上一个阶段寻找问题。

(4)中间产品是事后追溯的依据。一旦后续的某个阶段发现了错误,往往这个错误的原因是前面的工作错误引起的,那么,就需要向前面的阶段追溯。这样可以通过对中间产品的缺陷追溯,定位缺陷发生的原因(某个阶段的工作失误),避免今后再发生类似问题。