尽可能地采用现行的国家和国际标准，若现行的标准不适用，机构应制订自己的标准。

7.1 选择软件生存期模型

现有的一些软件生存期模型，对于不同的阶段有不同的词汇，从软件文档的观点来看，采用哪种模型都无关紧要，只要阶段和相应的文档是清晰定义的、已计划的，并且对于任何具体软件项目是能遵循的。因此，管理者应选择一个软件生存期模型并保证该模型在他们机构内是适用的。

管理者将会发现所进行的阶段和相应任务的定义有助于监控软件项目的进展。相应于特定阶段生成的文档可用作该阶段的评审、通过和完成的检验点，而这种检验应在下一阶段开始前进行。

7.2 规定文档类型和内容

下面给出软件文档主要类型的大纲，这个大纲不是详尽的或最后的，但适合作为主要类型软件文档的检验表。而管理者应规定何时定义他们的标准文档类型。

软件文档归入如下三种类别：

a) 开发文档——描述开发过程本身；

b) 产品文档——描述开发过程的产物；

c) 管理文档——记录项目管理的信息。

7.2.1 开发文档

开发文档是描述软件开发过程，包括软件需求、软件设计、软件测试、保证软件质量的一类文档，开发文档也包括软件的详细技术描述（程序逻辑、程序间相互关系、数据格式和存储等）。

开发文档起到如下五种作用：

a) 它们是软件开发过程中包含的所有阶段之间的通信工具，它们记录生成软件需求、设计、编码和测试的详细规定和说明；

b) 它们描述开发小组的职责。通过规定软件、主题事项、文档编制、质量保证人员以及包含在开发过程中任何其他事项的角色来定义做直截了当、如何做和何时做；

c) 它们用作检验点而允许管理者评定开发进度。如果开发文档丢失、不完整或过时，管理者将失去跟踪和控制软件项目的一个重要工具；

d) 它们形成了维护人员所要求的基本的软件支持文档。而这些支持文档可作为产品文档的一部分；

e) 它们记录软件开发的历史。

上一页  [1] [2] [3] [4] [5] [6] [7] [8]  下一页