计算机软件产品开发文件编制指南GB8567-88Guidelinesforcomputersoftwareproductdevelopmentdocumentation
中华人民共和国国家标准UDC681.3
引言
2范围本指南是一份指导性文件。本指甫建议,在一项计算机软件的开发过程中,一般地说,应该产生十四种文件。这十四种文件是:可行性研究报告;项目开发计划;软件需求说明书;数据要求说明书;概要设计说明书;详细设计说明书;数据库设计说明书;用户手册;操作手册;模块开发卷宗;测试计划;测试分析报告;开发进度月报;项目开发总结报告。本指南将给出开发过程中建议产生的这十四种文件的编制指导,同时,本指南也是这十四种文件的编写质量的检验准则。但是,本指南并未涉及软件开发过程中如何填写工作表格的问题。一般地说,一个软件总是一个计算机系统(包括硬件、固件和软件)的组成部分。鉴于计算机系统的多样性,本指南一般不涉及整个系统开发中的文件编制问题,本指南仅仅是软件开发过程中的文件编制指南。
3文件的使用者对于使用文件的人员而言,他们所关心的文件的种类,随他们所承担的工作而异。管理人员:可行性研究报告,项目开发计划,模块开发卷宗,开发进度月报,项目开发总结报告;开发人员:可行性研究报告,项目开发计划,软件需求说明书,数据要求说明书,概要设计说明书,详细设计说明书,数据库设计说明书,测试计划,测试分析报告;维护人员:设计说明书,测试分析报告,模块开发卷宗;用户:用户手册,操作手册。尽管本指南提出了在软件开发中文件编制的要求,但并不意味着这些文件都必须交给用户。一项软件的用户应该得到的文件的种类由供应者与用户之间签订的合同规定。
第一篇文件的编制指导
5文件编制中的考虑因素文件编制是一个不断努力的工作过程。是一个从形成最初轮廓,经反复检查和修改,直到程序和文件正式交付使用的完整过程。其中每一步都要求工作人员做出很大努力。要保证文件编制的质量,要体现每个开发项目的特点,也要注意不要花太多的人力。为此,编制中要考虑如下各项因素。
5.1文件的读者每一种文件都具有特定的读者。这些读者包括个人或小组、软件开发单位的成员或社会上的公众、从事软件工作的技术人员、管理人员或领导干部。他们期待着使用这些文件的内容来进行工作,例如设计、编写程序、测试、使用、维护或进行计划管理。因此,这些文件的作者必须了解自己的读者,这些文件的编写必须注意适应自己的特定读者的水平、特点和要求。
5.2重复性本指南第二篇中将列出的这十四种文件的内容要求中,显然存在某些重复。较明显的重复有两类。引言是每一种文件都要包含的内容,以向读者提供总的梗概。第二类明显的重复是各种文件中的说明部分,如对功能性能的说明、对输入和输出的描述、系统中包含的设备等。这是为了方便每种文件各自的读者,每种产品文件应该自成体系,尽量避免读一种文件时又不得不去参考另一种文件。当然,在每一种文件里,有关引言、说明等同其他文件相重复的部分,在行文上、在所用的术语上、在详细的程度上,还是应该有一些差别,以适应各种文件的不同读者的需要。
5.3灵活性鉴于软件开发是具有创造性的脑力劳动,也鉴于不同软件在规模上和复杂程度上差别极大,本指南认为在文件编制工作中应允许一定的灵活性。这种灵活性表现在如下各款。
5.3.2文件的详细程度从同一份提纲起草的文件的篇幅大小往往不同,可以少到几页,也可以长达几百页。对于这种差别本指南是允许的。此详细程度取决于任务的规模、复杂性和项目负责人对该软件的开发过程及运行环与所需要的详细程度的判断。
5.3.3文件的扩展当被开发系统的规模非常大(例如源码超过一百万行)时,一种文件可以分成几卷编写,可以按其。每一个系统分别编制,也可以按内容划分成多卷,例如:项目开发计划可能包括:质量保证计划,配置管理计划,用户培训计划,安装实施计划;系统设计说明书可分写成:系统设计说明书,子系统设计说明书;程序设计说明书可分写成:程序设计说明书,接口设计说明书,版本说明;操作手册可分写成:操作手册,安装实施过程;.测试计划可分写成:测试计划,测试设计说明,测试规程,测试用例;测试分析报告可分写成:综合测试报告,验收测试报告;项目开发总结报告亦可分写成项目开发总结报告和资源环境统计。
5.3.4节的扩张与缩并在有些文件中,可以使用本指南所提供的章、条标题,但在条内又存在一系列需要分别讨论的因素本指南认为,所有的条都可以扩展,可以进一步细分,以适应实际需要。反之,如果章条中的有些细节;非必需,也可以根据实际情况缩并。此时章条的编号应相应地改变。
5.3.5程序设计的表现形式本指南对于程序的设计表现形式并未作出规定或限制,可以使用流程图的形式、判定表的形式,1可以使用其他表现形式,如程序设计语言(PDL)、问题分析图(PAD)等。
5.3.6文件的表现形式本指南对于文件的表现形式亦未作出规定或限制,可以使用自然语言,也可以使用形式化语言。
5.3.7文件的其他种类当本指南中规定的文件种类尚不能满足某些应用部门的特殊需要时,他们可以建立一些特殊的文件种类要求,例如软件质量保证计划、软件配置管理计划等,这些要求可以包含在本单位的文件编制实施规定中。
6文件编制的管理工作文件编制工作必须有管理工作的配合,才能使所编制的文件真正发挥它的作用。文件的编制工作实际上贯穿于一项软件的整个开发过程,因此,对文件的管理必须贯穿于整个开发过程。在开发过程中必须进行的管理工作是以下四条。
6.1文件的形成开发集体中的每个成员,尤其是项目负责人,应该认识到:文件是软件产品的必不可少的组成部分;在软件开发过程的各个阶段中,必须按照规定及时地完成各种产品文件的编写工作;必须把在一个开发步骤中作出的决定和取得的结果及时地写入文件;开发集体必须及时地对这些文件进行严格的评审;这些文件的形成是各个阶段开发工作正式完成的标志。这些文件上必须有编写者、评审者和批准者的签字,必须有编写、评审完成的日期和批准的日期。
6.2文件的分类与标识在软件开发的过程中,产生的文件是很多的,为了便于保存、查找、使用和修改,应该对文件按层次地加以分类组织。一个软件开发单位应该建立一个对本单位文件的标识方法,使文件的每一页都具有明确的标识。例如可以按如下四个层次对文件加以分类和标识。a.文件所属的项目的标识;b.文件种类的标识;C.同一种文件的不同版本号;d.页号。此外,对每种文件还应根据项目的性质,划定它们各自的保密级别,确定他们各自的发行范围。
第二篇各种文件的内容要求本篇将对引言中提到的十四种文件提供内容要求,作为文件编制的技术标准。
8项目开发计划编制项目开发计划的目的是用文件的形式,把对于在开发过程中各项工作的负责人员、开发进度、所需经费预算、所需软、硬件条件等问题作出的安排记载下来,以便根据本计划开展和检查本项目的开发工作。编制内容要求如下:8.1引言8.1.1编写目的8.1.2背景8.1.3定义8.1.4参考资料8.2项目概述8.2.1作内容8.2.2主要参加人员8.2.3产品及成果8.2.3.1程序8.2.3.2文件8.2.3.3服务8.2.3.4非移交产品8.2.4验收标准8..2.5完成项目的最迟期限8.2.6本计划的审查者与批准者8.3实施总计划8.3.1工作任务的分解8.3.2接口人员8.3.3进度8.3.4预算8.3.5关键问题8.4支持条件8.4.1计算机系统支持8.4.2需要用户承担的工作8.4.3需由外单位提供的条件8.5专题计划要点
10数据要求说明书数据要求说明书的编制目的是为了向整个开发时期提供关于被处理数据的描述和数据采集要求的技术信息。编制数据要求说明书的内容要求如下:10.1引言10.1.1编写目的10.1.2背景10.1.3定义10.1.4参考资料10.2数据的逻辑描述10.2.1静态数据10.2.2动态输入数据10.2.3动态输出数据10.2.4内部生成数据10.2.5数据约定10.3数据的采集10.3.1要求和范围10.3.2输入的承担者10.3.3处理10.3.4影响。
15操作手册操作手册的编制是为了向操作人员提供该软件每一个运行的具体过程和有关知识,包括操作方法的细节。具体的内容要求如下:15.1引言15.1.1编写目的15.1.2背景15.1.3定义15.1.4参考资料15.2软件概述15.2.1软件的结构15.2.2程序表15.2.3文卷表15.3安装与初始化15.4运行说明15.4.1运行表15.4.2运行步骤15.4.3运行1(标识符)说明15.4.3.1运行控制15.4.3.2操作信息15.4.3.3输入一输出文卷15.4.3.4输出文段15.4.3.5输出文段的复制15.4.3.6启动恢复过程15.4.4运行2(标识符)说明......15.5非常现过程15.6远程操作
16.3功能说明16.4设计说明16.5源代码清单16.6测试说明16.7复审的结论17测试计划这里所说的测试,主要是指整个程序系统的组装测试和确认测试。本文件的编制是为了提供一个对该软件的测试计划,包括对每项测试活动的内容、进度安排、设计考虑、测试数据的整理方法及评价准则。具体的内容要求如下:17.1引言17.1.1编写目的17.1.2背景17.1.3定义17.1.4参考资料17.2计划17.2.1软件说明17.2.2测试内容17.2.3测试1(标识符)17.2.3.1进度安排17.2.3.2条件17.2.3.3测试资料17.2.3.4测试培训17.2.4测试2(标识符)......17.3测试设计说明17.3.1测试l(标识符)17.3.1.1控制17.3.1.2输入17.3.1.3输出17.3.1.4过程17.3.2测试2(标识符).......17.4评价准则17.4.1范围17.4.2数据整理17.4.3尺度
18测试分析报告测试分析报告的编写是为了把组装测试和确认测试的结果、发现及分析写成文件加以记载,具体的内容要求如下:18.1引言18.1.1编写目的18.1.2背景18.1.3定义18.1.4参考资料18.2测试概要18.3测试结果及发现18.3.1测试1(标识符)18.3.2测试2(标识符)......18.4对软件功能的结论18.4.1功能1(标识符)18.4.1.1能力18.4.1.2限制18.4.2功能2(标识符)18.5分析摘要18.5.1能力18.5.2缺陷和限制18.5.3建议18.5.4评价18.6测试资源消耗
19开发进度月报开发进度月报的编制目的是及时向有关管理部门汇报项目开发的进展和情况,以便及时发现和处理开发过程中出现的问题。一般地,开发进度月报是以项目组为单位每月编写的。如果被开发的软件系统规模比较大,整个工程项目被划分给若干个分项目组承担,开发进度月报将以分项目组为单位按月编写。具体的内容要求如下:19.1标题19.2工程进度与状态19.2.1进度19.2.2状态19.3资源耗用与状态19.3.1资源耗用19.3.1.1工时19.3.1.2机时19.3.2状态19.4经费支出与状态19.4.1经费支出19.4.1.1支持性费用19.4.1.2设备购置费19.4.2状态19.5下个月的工作计划19.6建议
20项目开发总结报告项目开发总结报告的编制是为了总结本项目开发工作的经验,说明实际取得的开发结果以及对整个开发工作的各个方面的评价。具体的内容要求如下:20.1引言20.1.1编写目的20.1.2背景20.1.3定义20.1.4参考资料20.2.1产品20.2实际开发结果20.2.2主要功能和性能20.2.3基本流程20.2.4进度20.2.5费用20.3开发工作评价20.3.1对生产效率的评价20.3.2对产品质量的评价20.3.3对技术方法的评价20.3.4出错原因的分析20.4经验与教训
附录A
A.5可选择的其他系统方案扼要说明曾考虑过的每一种可选择的系统方案,包括需开发的和可从国内国外直接购买的,如果没有供选择的系统方案可考虑,则说明这一点。A.5.1可选择的系统方案1参照第A.4章的提纲,说明可选择的系统方案1,并说明它未被选中的理由。A.5.2可选择的系统方案2按类似A.5.1条的方式说明第2个乃至第。个可选择的系统方案。......
A.8结论在进行可行性研究报告的编制时,必须有一个研究的结论。结论可以是:a.可以立即开始进行;b.需要推迟到某些条件(例如资金、人力、设备等)落实之后才能开始进行;c.需要对开发目标进行某些修改之后才能开始进行;d.不能进行或不必进行(例如因技术不成熟、经济上不合算等)。
附录B项目开发计划的编写提示
B.2项目概述B.2.1工作内容简要地说明在本项目的开发中须进行的各项主要工作。B.2.2主要参加人员扼要说明参加本项目开发工作的主要人员的情况,包括他们的技术水平。B.2.3产品B.2.31程序列出需移交给用户的程序的名称、所用的编程语言及存储程序的媒体形式,并通过引用有关文件,逐项说明其功能和能力。B.2.3.2文件列出需移交给用户的每种文件的名称及内容要点。B.2.3.3服务列出需向用户提供的各项服务,如培训安装、维护和运行支持等,应逐项规定开始日期、所提供支持的级别和服务的期限。B.2.3.4非移交的产品说明开发集体应向本单位交出但不必向用户移交的产品(文件甚至某些程序)。B.2.4验收标准对于上述这些应交出的产品和服务,逐项说明或引用资料说明验收标准。B.2.5完成项目的员迟用限B.2.6本计划的批准者和批准日期
B.5专题计划要点说明本项目开发中需制订的各个专题计划(如分合同计划、开发人员培训计划、测试计划、安全保密计划、质量保证计划、配置管理计划、用户培训计划、系统安装计划等)的要点。
附录C软件需求说明书的编写提示
C.2任务概述C.2.1目标叙述该项软件开发的意图、应用目标、作用范围以及其他应向读者说明的有关该软件开发的背景材料。解释被开发软件与其他有关软件之间的关系。如果本软件产品是一项独立的软件,而且全部内容自含,则说明这一点。如果所定义的产品是一个更大的系统的一个组成部分,则应说明本产品与该系统中其他各组成部分之间的关系,为此可使用一张方框图来说明该系统的组成和本产品同其他各部分的联系和接口。|C.2.2用户的特点列出本软件的最终用户的特点,充分说明操作人员、维护人员的教育水平和技术专长,以及本软件的预期使甩频度。这些是软件设计工作的重要约束C.2.3假定和约束列出进行本软件开发工作的假定和约束,例如经费限制、开发期限等。
附录E概要设计说明书的编写提示
E.2总体设计E.2.1需求规定说明对本系统的主要的输入输出项目、处理的功能性能要求,详细的说明可参见附录C。E.2.2运行环境简要地说明对本系统的运行环境(包括硬件环境和支持环境)的规定,详细说明参见附录C。E.2.3基本设计概念和处理流程说明本系统的基本设计概念和处理流程,尽量使用图表的形式。E.2.4结构用一览表及框图的形式说明本系统的系统元素(各层模块、子程序、公用程序等)的划分,扼要说明每个系统元素的标识符和功能,分层次地给出各元素之间的控制与被控制关系.E.2.5功能器求与程序的关系本条用一张如下的矩阵图说明各项功能需求的实现同各块程序的分配关系:
E.2.6人工处理过程说明在本软件系统的工作过程中不得不包含的人工处理过程(如果有的话)。E.2.7尚未问决的问题说明在概要设计过程中尚未解决而设计者认为在系统完成之前必须解决的各个问题。
E.3接口设计E.3.1用户接口说明将向用户提供的命令和它们的语法结构,以及软件的回答信息。E.3.2外部接口说明本系统同外界的所有接口的安排包括软件与硬件之间的接口、本系统与各支持软件之间的接口关系。E.3.3内部接口说明本系统之内的各个系统元素之间的接口的安排。
E.6系统出错处理设计E.6.1出错信息用一览表的方式说朗每种可能的出错或故障情况出现时,系统输出信息的形式、含意及处理方法。E.6.2补救措施说明故障出现后可能采取的变通措施,包括:a.后备技术说明准备采用的后备技术,当原始系统数据万一丢失时启用的副本的建立和启动的技术,例如周期性地把磁盘信息记录到磁带上去就是对于磁盘媒体的一种后备技术;b.降效技术说明准备采用的后备技术,使用另一个效率稍低的系统或方法来求得所需结果的某些部分,例如一个自动系统的降效技术可以是手工操作和数据的人工记录;c.恢复及再启动技术说明将使用的恢复再启动技术,使软件从故障点恢复执行或使软件从头开始重新运行的方法。E.6.3系统维护设计说明为了系统维护的方便而在程序内部设计中作出的安排,包括在程序中专门安排用于系统的检查与维护的检测点和专用模块。各个程序之间的对应关系,可采用如下的矩阵图的形式;
附录F详细设计说明书的编写提示
F.2程序系统的结构用一系列图表列出本程序系统内的每个程序(包括每个模块和子程序)的名称、标识符和它们之间的层次结构关系。
G.3结构设计G.3.1概念结构设计说明本数据库将反映的现实世界中的实体、属性和它们之间的关系等的原始数据形式,包括各数据项、记录、系、文卷的标识符、定义、类型、度量单位和值域,建立本数据库的每一幅用户视图。G.3.2逻辑结构设计说明把上述原始数据进行分解、合并后重新组织起来的数据库全局逻辑结构,包括所确定的关键字和属性、重新确定的记录结构和文卷结构、所建立的各个文卷之间的相互关系,形成本数据库的数据库管理员视图。G.3.3物理结构设计建立系统程序员视图,包括:a.数据在内存中的安排,包括对索引区、缓冲区的设计;b.所使用的外存设备及外存空间的组织,包括索引区、数据块的组织与划分;c.访问数据的方式方法。
G.4运用设计G.4.1数据字典设计对数据库设计中涉及到的各种项目,如数据项、记录、系、文卷、模式、子模式等一般要建立起数据字典,以说明它们的标识符、同义名及有关信息。在本节中要说明对此数据字典设计的基本考虑。G.4.2安全保密设计说明在数据库的设计中,将如何通过区分不同的访问者、不同的访问类型和不同的数据对象,进行分别对待而获得的数据库安全保密的设计考虑。
附录H用户手册的编写提示
H.3运行环境H.3.1硬设备列出为运行本软件所要求的硬设备的最小配置,如:a.处理机的型号、内存容量;b.所要求的外存储器、媒体、记录格式、设备的型号和台数、联机/脱机;c.I/O设备(联机/脱机?);d.数据传输设备和转换设备的型号、台数。H.3.2支持软件说明为运行本软件所需要的支持软件,如:a.操作系统的名称、版本号;b.程序语言的编译/汇编系统的名称和版本号;c.数据库管理系统的名称和版本号;d.其他支持软件。H.3.3数据结构列出为支持本软件的运行所需要的数据库或数据文卷。
I.2软件征述I.2.1软件的结构结合软件系统所具有的功能包括输入、处理和输出提供该软件的总体结构图表。I.2.2程序表列出本系统内每个程序的标识符、编号和助记名。I.2.3文卷表列出将由本系统引用、建立或更新的每个永久性文卷,说明它们各自的标识符、编号、助记名、存储媒体和存储要求。
I.3安装与初始化一步一步地说明为使用本软件而需要进行的安装与初始化过程,包括程序的存载形式,安装与初始化过程中的全部操作命令,系统对这些命令的反应与答复,表征安装工作完成的测试实例等。如果有的话,还应说明安装过程中所需用到的专用软件。
I.5非常规过程提供有关应急操作或非常规操作的必要信息,如出错处理操作、向后备系统的切换操作以及其他必须向程序维护人员交待的事项和步骤。
I.6远程操作如果本软件能够通过远程终端控制运行,则在本章说明通过远程终端运行本软件的操作过程。附录J模块开发卷宗的编写提示
附录K测试计划的编写提示
K.3测试设计说明K.3.1测试1(标识符)说明对第一项测试内容的测试设计考虑。K.3.1.1控制说明本测试的控制方式,如输入是人工、半自动或自动引入、控制操作的顺序以及结果的记录方法。K.3.1.2输入说明本项测试中所使用的输入数据及选择这些输入数据的策略。K.3.1.3输出说明预期的输出数据,如测试结果及可能产生的中间结果或运行信息。K.3.1.4过程说明完成此项测试的一个个步骤和控制命令,包括测试的准备、初始化、中间步聚和运行结束方式。K.3.2测试2(标识符)用与本测试计划K.3.l条相类似的方式说明第2项及其后各项测试工作的设计考虑。
K.4评价准则K.4.1范围说明所选择的测试用例能够接查的范围及其局限性。K.4.2数据整理陈述为了把测试数据加工成便于评价的适当形式,使得测试结果可以同,已知结果进行比较而要用到的转换处理技术,如手工方式或自动方式;如果是用自动方式整理数据,还要说明为进行处理而要用到的硬件、软件资源。K.4.3尺度说明用来判断测试工作是否能通过的评价尺度,如合理的输出结果的类型、测试输出结果与预期输出之间的容许偏离范围、允许中断或停机的最大次数。
附录L测试分析报告的编写提示
L.2测试概要用表格的形式列出每一项测试的标识符及其测试内容,并指明实际进行的测试工作内容与测试计划中预先设计的内容之间的差别,说明作出这种改变的原因。
L.3测试结果及发现L.3.1测试1(标识符)把本项测试中实际得到的动态输出(包括内部生成数据输出)结果同对于动态输出的要求进行比较,陈述其中的各项发现。L.3.2测试2(标识符)用类似本报告L.3.1条的方式给出第2项及其后各项测试内容的测试结果和发现。
L.4对软件功能的结论L.4.1功能1(标识符)L.4.1.1能力简述该项功能,说明为满足此项功能而设计的软件能力以及经过一项或多项测试已证实的能力。L.4.1.2限制说明测试数据值的范围(包括动态数据和静态数据),列出就这项功能而言,测试期间在该软件中查出的缺陷、局限性。L.4.2功能2(标识符)用类似本报告L.4.l的方式给出第2项及其后各项功能的测试结论。......
L.5分析摘要L.5.1能力陈述经测试证实了的本软件的能力。如果所进行的测试是为了验证一项或几项特定性能要求的实现,应提供这方面的测试结果与要求之间的比较,并确定测试环境与实际运行环境之间可能存在的差异对能力的测试所带来的影响。L.5.2缺陷和限制陈述经测试证实的软件缺陷和限制,说明每项缺陷和限制对软件性能的影响,并说明全部测得的性能缺陷的累积影响和总影响。L.5.3建议对每项缺陷提出改进建议,如:a.各项修改可采用的修改方法;b.各项修改的紧迫程度;c.各项修改预计的工作量;d.各项修改的负责人。L.5.4评价说明该项软件的开发是否已达到预定目标,能否交付使用。
L.6测试资源消耗总结测试工作的资源消耗数据,如工作人员的水平级别数量、机时消耗等。附录M开发进度月报的缩写提示
M.l标题开发中的软件系统的名称和标识符分项目名称和标识符分项目负责人签名本期月报编写人签名本期月报的编号及所报告的年月
M.2工程进度与状态M.2.1进度列出本月内进行的各项主要活动,并且说明本月内遇到的重要事件,这里所说的重要事件是指一个开发阶段(即软件生存周期内各个阶段中的某一个,例如需求分析阶段)的开始或结束,要说明阶段名称及开始(或结束)的日期。M.2.2状态说明本月的实际工作进度与计划相比,是提前了、按期完成了、或是推迟了?如果与计划不一致,说明原因及准备采取的措施。
M.3资额耗用与状态M.3.1资额耗用主要说明本月份内耗用的工时与机时。M.3.1.1工时分为三类:a.管理用工时包括在项目管理(制订计划、布置工作、收集数据、检查汇报工作等)方面耗用的工时;b.服务工时包括为支持项目开发所必须的服务工作及非直接的开发工作所耗用的工时;C.开发用工时要分各个开发阶段填写。M.3.1.2机时说明本月内耗用的机时,以小时为单位,说明计算机系统的型号。M.3.2状态说明本月内实际耗用的资源与计划相比,是超出了、相一致、还是不到计划数?如果与计划不一致,说明原因及准备采取的措施。
M.4经费支出与状态M.4.1经费支出M.4.1.1支持性费用列出本月内支出的支持性费用,一般可按如下七类列出,并给出本月支持费用的总和:a.房租或房屋折旧费;b.社工资、奖金、补贴;c.培训费包括给教师的酬金及教室租金;d.资料费包括复印及购买参考资料的费用;e.会议费召集有关业务会议的费用;f.旅差费;g.其他费用。M.4.1.2设备购置费列出本月内支出的设备购置费,一般可分如下三类:a.购买软件的名称与金额;b.购买硬设备的名称、型号、数量及金额;c.已有硬设备的折旧费。M.4.2状态说明本月内实际支出的经费与计划相比较,是超过了。相符合、还是不到计划数?如果与计划不一致,说明原因及准备采取的措施。
M.5下个月的工作计划
M.6建议本月遇到的重要问题和应引起重视的问题以及因此产生的建议。
附录N项目开发总结报告的编写提示
N.3开发工作评价N.3.1对生产效率的评价给出实际生产效率,包括:a.程序的平均生产效率,即每人月生产的行数;b.文件的平均生产效率,即每人月生产的千字数;并列出原订计划数作为对比。N.3.2对产品质量的评价说明在测试中检查出来的程序编制中的错误发生率,即每干条指令(或语句)中的错误指令数(或语句数)。如果开发中制订过质量保证计划或配置管理计划,要同这些计划相比较。N.3.3对技术方法的评价给出对在开发中所使用的技术、方法、工具、手段的评价。N.3.4出错原因的分析给出对于开发中出现的错误的原因分析。
N.4经验与教训列出从这项开发工作中所得到的最主要的经验与教训及对今后的项目开发工作的建议。
附录O文件给制实施规定的实例
附加说明:本标准由中华人民共和国电子工业部提出。本标准由中国软件技术公司负责起草。本标准主要起草人应明、崔涛、刘林。