1
 软件工程
1.11.3.2 9.3.2 文档的管理与维护

9.3.2 文档的管理与维护

在整个软件生存周期中,各种文档作为半成品或是最终成品,会不断地生成、修改或补充。为了最终得到高质量的产品,达到提出质量的要求,必须加强对文档的管理。以下几个方面是应注意做到的。

(1)软件开发小组应设一位文档保管人员,负责集中保管本项目已有文档的两套主文本。两套主文本内容完全一致,其中的一套可按一定手续办理借阅。

(2)软件开发小组的成员可根据工作需要在自己手中保存一些个人文档。这些一般都应是主文本的复印件,并注意和主文本保持一致,在做必要的修改时,也应先修改主文本。

(3)开发人员个人只保存主文本中与其工作相关的部分文档。

(4)在新文档取代了旧文档时,管理人员应及时注销旧文档。在文档内容有变动时,管理人员应随时修订主文本,使其及时反映更新了的内容。

(5)项目开发结束时,文档管理人员应收回开发人员的个人文档。发现个人文档与主文本有差别时,应立即着手解决,这常常是由于未及时修订主文本造成的。

(6)在软件开发过程中,可能发现需要修改已完成的文档,特别是规模较大的项目,主文本的修改必须特别谨慎。修改以前要充分估计修改可能带来的影响,并且要按照提议、评议、审核、批准和实施等步骤加以严格的控制。