软件生存周期与各种文件的编制
   一项计算机软件，从出现一个构思之日起，经过这项软件开发成功投入使用，直到最后决定停止使 用，并被另一一项软件代替之时止，被认为是该软件的一个生存周期。一般地说这个软件生存周期可以分成以下六个阶段：可行性与计划研究阶段
          需求分析阶段
          设计阶段
          实现阶段
          测试阶段
          运行与维护阶段
   在可行性研究与计划阶段内，要确定该软件的开发目标和总的要求，要进行可行性分析、投资一收益分析、制订开发计划，并完成应编制的文件。
   在需求分析阶段内，由系统分析人员对被设计的系统进行系统分析，确定对该软件的各项功能、性能需求和设计约束，确定对文件编制的要求，作为本阶段工作的结果，一般地说，软件需求说明书、数据要求说明书和初步的用户手册应该编写出来。
   在设计阶段内，系统设计人员和程序设计人员应该在反复理解软件需求的基础上，提出多个设计，分析每个设计能履行的功能并进行相互比较，最后确定一个设计，包括该软件的结构、模块的划分、功能的分配以及处理流程。在被设计系统比较复杂的情况下，设计阶段应分解成概要设计阶段和详细设计阶段两个步骤。在一般情况下，应完成的文件包括：概要设计说明书、详细设计说明书和测试计划初稿。
   在实现阶段内，要完成源程序的编码、编译（或汇编）和排错调试得到无语法错的程序清单，要开始编写模块开发卷宗，并且要完成用户手册、操作手册等面向用户的文件的编写工作，还要完成测试计划的编制。
   在测试阶段，该程序将被全面地测试，已编制的文件将被检查审阅。一般要完成模块开发卷宗和测试分析报告，作为开发工作的结束，所生产的程序、文件以及开发工作本身将逐项被评价，最后写出项目开发总结报告。
   在整个开发过程中（即前五个阶段中），开发集体要按月编写开发进度月报。
   在运行和维护阶段，软件将在运行使用中不断地被维护，根据新提出的需求进行必要而且可能的扩充和删改。
   对于一项软件而言，其生存周期各阶段与各种文件编写工作的关系可见表互，其中有些文件的编写工作可能要在若干个阶段中延续进行。
                      表1软件生存周期各阶段中的文件编制

5 文件编制中的考虑因素
   文件编制是一个不断努力的工作过程。是一个从形成最初轮廓，经反复检查和修改，直到程序和文件正式交付使用的完整过程。其中每一步都要求工作人员做出很大努力。要保证文件编制的质量，要体现每个开发项目的特点，也要注意不要花太多的人力。为此，编制中要考虑如下各项因素。

5．1 文件的读者
    每一种文件都具有特定的读者。这些读者包括个人或小组、软件开发单位的成员或社会上的公众、从事软件工作的技术人员、管理人员或领导干部。他们期待着使用这些文件的内容来进行工作，例如设计、编写程序、测试、使用、维护或进行计划管理。因此，这些文件的作者必须了解自己的读者，这些文件的编写必须注意适应自己的特定读者的水平、特点和要求。

5．2 重复性
    本指南第二篇中将列出的这十四种文件的内容要求中，显然存在某些重复。较明显的重复有两类。引言是每一种文件都要包含的内容，以向读者提供总的梗概。第二类明显的重复是各种文件中的说明部分，如对功能性能的说明、对输入和输出的描述、系统中包含的设备等。这是为了方便每种文件各自的读者，每种产品文件应该自成体系，尽量避免读一种文件时又不得不去参考另一种文件。当然，在每一种文件里，有关引言、说明等同其他文件相重复的部分，在行文上、在所用的术语上、在详细的程度上，还是应该有一些差别，以适应各种文件的不同读者的需要。

5．3 灵活性
    鉴于软件开发是具有创造性的脑力劳动，也鉴于不同软件在规模上和复杂程度上差别极大，本指南认为在文件编制工作中应允许一定的灵活性。这种灵活性表现在如下各款。

5．3．1 应编制的文件种类
   尽管本指南认为在一般情况下，一项软件的开发过程中，应产生的文件有十四种，然而针对一项具体的软件开发项目，有时不必编制这么多的文件，可以把几种文件合并成一种。一般地说，当项目的规模、复杂性和成败风险增大时，文件编制的范围、管理手续和详细程度将随之增加。反之，则可适当减少。为了恰当地掌握这种灵活性，本指南要求贯彻分工负责的原则，这意味着：
   a: 一个软件开发单位的领导机构应该根据本单位经营承包的应用软件的专业领域和本单位的管理能力，制定一个对文件编制要求的实施规定，主要是：在不同的条件下，应该形成哪些文件？这些文件的详细程度？该开发单位的每一个项目负责人，必须认真执行这个实施规定。这种规定的两个例子可叹 本指南的附录o（参考件）；
   b．对于一个具体的应用软件项目，项目负责人应根据上述实施规定，确定一个文件编制计划，主 中包括:
  (1)应该编制哪几种文件，详细程度如何？
 （2）各个文件的编制负责人和进度要求；
 （3）审查、批准的负责人和时间进度安排；
 （4）在开发时期内，各文件的维护、修改和管理的负责人，以及批准手续。
  每项工作必须落实到人。
  这个文件编制计划是整个开发计划的重要组成部分；
   C．有关的设计人员则必须严格执行这个文件编制计划。

5．3．2 文件的详细程度
   从同一份提纲起草的文件的篇幅大小往往不同，可以少到几页，也可以长达几百页。对于这种差别本指南是允许的。此详细程度取决于任务的规模、复杂性和项目负责人对该软件的开发过程及运行环与所需要的详细程度的判断。

5．3．3 文件的扩展
   当被开发系统的规模非常大（例如源码超过一百万行）时，一种文件可以分成几卷编写，可以按其。 每一个系统分别编制，也可以按内容划分成多卷，例如：
   项目开发计划可能包括：质量保证计划，
                         配置管理计划，
                         用户培训计划，
                         安装实施计划；
   系统设计说明书可分写成：系统设计说明书，
                           子系统设计说明书；
   程序设计说明书可分写成：程序设计说明书，
                           接口设计说明书，
                           版本说明；
   操作手册可分写成：操作手册，
                     安装实施过程；
 ．测试计划可分写成：测试计划，
                     测试设计说明，
                     测试规程，
                     测试用例；
   测试分析报告可分写成：综合测试报告，
                         验收测试报告；
   项目开发总结报告亦可分写成项目开发总结报告和资源环境统计。

5．3．4 节的扩张与缩并
   在有些文件中，可以使用本指南所提供的章、条标题，但在条内又存在一系列需要分别讨论的因素 本指南认为，所有的条都可以扩展，可以进一步细分，以适应实际需要。反之，如果章条中的有些细节； 非必需，也可以根据实际情况缩并。此时章条的编号应相应地改变。

5．3．5 程序设计的表现形式
   本指南对于程序的设计表现形式并未作出规定或限制，可以使用流程图的形式、判定表的形式，1 可以使用其他表现形式，如程序设计语言（PDL）、问题分析图（PAD）等。

5．3．6 文件的表现形式
   本指南对于文件的表现形式亦未作出规定或限制，可以使用自然语言，也可以使用形式化语言。

5．3．7 文件的其他种类
   当本指南中规定的文件种类尚不能满足某些应用部门的特殊需要时，他们可以建立一些特殊的文件种类要求，例如软件质量保证计划、软件配置管理计划等，这些要求可以包含在本单位的文件编制实施规定中。