JB 5235-1991工业控制实时软件文档管理指南.pdf

丁B中华人民共和国机械行业标准JB/T 5235—91工业控制实时软件文档管理指南1997-07-10发布1992-07-01实施机械电子工业部发布 中华人民共和国机械行业标准JB/T 528591工业控制实时软件文档管理指南主题内容与适用范围本标准规定了工业控制实时软件文档管理的基本任务和管理要点，为项目管理者实施该类文档的管理提供管理指南。本标准适用于工业控制实时软件文档的管理。2引用标准GB/T11457—89《软件工程术语》JB/T5236—91《工业控制实时软件工程化文档规范》3术语GB/T1145789《软件工程术语》中规定的术语适用于本标准。以下术语仅适用于本标准。3.1用户usera.使用软件求解某一间题的个人，例如测试和操作人员；b实际使用软件产品、操作运行软件的组织、单位或个人。3.2产品文档product documentation软件项目开发过程应当编制的各种技术资料或技术管理资料。3.3工作文档work documentation软件项目开发过程中所填写的或使用过的各种图表或文字资料的综合。38.4用户需求user requirement用户所期望的软件产品的全部性能、功能和限制。它主要包括对软件产品的功能要求、性能要求、如实时性、在线性、可靠性和可维护性要求以及安全保密要求。还包括在开发费用、时间、进度和可用资源等方面的限制。3.5复审review软件项目开发中的--个重要环节。它是对某个开发产品过程进行的全面检查、鉴定和认可。目的在于尽可能旱地发现错误，对实现和要求进行统一和协调。3.6软件开发库sottware development library存放与软件开发工作有关的计算机可读信息和人们可读信息的软件库。3.7配置管理库configuration management library机械电子工业部1991-07-10批准1092-07-01实施 JB/T 523581技术准确度；c.总体的完备性；d.对各类读者的适合程度；e.图表编制计划和最后用到的图表（也应接受技术准确度、完备性及适合程度等各种分项复审）；f.文法、标点符号和其它技术细节的正确性；g.文档格式应符合JB/T5236—91的有关规定。软件文植的配置管理软件配置是指软件应当提供和保全的程序、文档、数据以及各种文字资料的有序集合。其中每个独立的文本及其集合都势为一个软件配置项，软件配置营理的主要任务是：a.建立软件文档标准及软件文档标识体制；b.评价及记录软件配置项的变动情况，并控制这些变动；c.严格跟踪并控制已确认的软件配置项；d.不新检变软件配置。8管理要点总结为了检查在软件项目的开发过程中是否实施软件文档的有效管理，项目管理者必须回答以下问题；a.是否明确划分了软件生存周期的各个阶段？是否确定了需要编制的软件文档的种类？b.是否指定专人负责工作文档与产品文档的准备工作？是否列出与款件文档的编制有关的国家标准或行业标准的清单？如果尚无相应标准，是否制订出规范对文档内容、格式及标识方式作出明确规定？C是否提出了软件文档编制计刘？对要编制的每种文档，承担下述工作的人员责任是否明确？文档的准备和起章；项目库管理程序；文档存储；文档复审绘制图表质量保证d。是否规定了文档的编创过程，包括什么时候完成什么文档的编制？对以下各项工作是否已确定交付进度？准备章案；提出草案第一稿；修改草案；绘制图表。e，是否确立软件文档质量评定准则？是否建立质量保证机构或指定人员负责文档质量？f，是否建文文档复审制度？是否考虑让分析员、开发者、程序员、维护人员、审核人员、用户和管理人员参予复审？g．是否对软件文档按层次分类标识，注明项目、文档品种、版本号、页号并确定文档密级和分发范围？h。是否对软件文档的修改活动进行过管理和控制，规定了修改活动的规程？1，是否对软件文档的修改进行过周密的控制，以保持文和程序的一致性，文档间的一致性和安全性，并保证副本（在开发人员手中）与库存文档的一致性？j．是否确立保证软件文档先进性的办法？为保证工业控制实时款件的实时性、在线性、高可靠性10 JB/T828501和可维护性，软件文格是否作了相应考虑？k.为了得到用户对文档的评价和意见，是否建立了相应的反馈机构？1是否为重要文档的存储提供了便测条件？是否已经具备开发软件文档的资料？m，是否列出款件支持工具和考虑采用自动化文档技术？11 JB/T 528591附景A软件生存周期的定义及除段划分(参考件)A1款件生存周期的定义根据GB/T11457一89《软件工程术语》，软件生存周期指的是“从软件产品的开发设计开始到产品不能再使用时为止的时间周期。它典型的包括第求阶段、设计阶段、实现阶段、验证与测试阶段、安装验收阶段、运行维护阶段，有时还包括引退阶段”。为使用方便，本标