13.2.4 软件文档的管理维护
在整个软件生存期中,各种文档作为半成品或是最终产品,会不断生成、修改或补充。为了最终得到高质量的产品,达到上面提出的质量要求,必须按下面的要求加强对文档的管理。
(1)软件开发小组应设一位文档保管员,负责集中保管本项目已有文档的两套主文本。这两套主文本的内容完全一致。其中一套可按一定手续办理借阅。
(2)软件开发小组的成员可根据工作需要在自己手中保存一些个人文档。这些一般都应是主文本的复制件,并注意与主文本保持一致,在做必要的修改时,也应先修改主文本。
(3)开发人员个人只保存着主文本中与他工作有关的部分文档。(https://www.daowen.com)
(4)在新文档取代旧文档时,管理人员应及时注销旧文档。在文档的内容有变更时,管理人员应随时修订主文本,使其及时反映更新了的内容。
(5)项目开发结束时,文档管理人员应收回开发人员的个人文档。发现个人文档与主文档有差别时,应立即着手解决。这往往是在开发过程中没有及时修订主文本造成的。
(6)在软件开发过程中,可能发现需要修改已完成的文档。特别是规模较大的项目,主文本的修改必须特别谨慎。修改以前要充分估计修改可能带来的影响,并且要按照如下步骤加以严格的控制:提议→评议→审核→批准→实施。