欢迎来到冰豆网! | 帮助中心 分享价值,成长自我!
冰豆网
全部分类
  • IT计算机>
  • 经管营销>
  • 医药卫生>
  • 自然科学>
  • 农林牧渔>
  • 人文社科>
  • 工程科技>
  • PPT模板>
  • 求职职场>
  • 解决方案>
  • 总结汇报>
  • 党团工作>
  • ImageVerifierCode 换一换
    首页 冰豆网 > 资源分类 > DOCX文档下载
    分享到微信 分享到微博 分享到QQ空间

    软件文档编写规定Word格式.docx

    • 资源ID:17032786       资源大小:45.96KB        全文页数:51页
    • 资源格式: DOCX        下载积分:12金币
    快捷下载 游客一键下载
    账号登录下载
    微信登录下载
    三方登录下载: 微信开放平台登录 QQ登录
    二维码
    微信扫一扫登录
    下载资源需要12金币
    邮箱/手机:
    温馨提示:
    快捷下载时,用户名和密码都是您填写的邮箱或者手机号,方便查询和重复下载(系统自动生成)。
    如填写123,账号就是123,密码也是123。
    支付方式: 支付宝    微信支付   
    验证码:   换一换

    加入VIP,免费下载
     
    账号:
    密码:
    验证码:   换一换
      忘记密码?
        
    友情提示
    2、PDF文件下载后,可能会被浏览器默认打开,此种情况可以点击浏览器菜单,保存网页到桌面,就可以正常下载了。
    3、本站不支持迅雷下载,请使用电脑自带的IE浏览器,或者360浏览器、谷歌浏览器下载即可。
    4、本站资源下载后的文档和图纸-无水印,预览文档经过压缩,下载后原文更清晰。
    5、试题试卷类文档,如果标题没有明确说明有答案则都视为没有答案,请知晓。

    软件文档编写规定Word格式.docx

    1、5.3.3 标准文档的剪裁除另有规定外,本标准规定的各种软件文档可根据各产品的性质、特点等具体情况进行剪裁,并应在产品的软件设计与编码规范中明确。如:产品规模较小时,可将“软件需求规格说明”和“接口需求规格说明”合并拟制,接口的需求可插入“软件需求规格说明”文档中;“计算机系统操作员手册”、“软件用户手册”和“软件程序员手册”可将有关章节合并至“软件用户手册”中;对于无人机界面的软件,其有关操作、使用方法和注意事项等可写入系统的技术说明书和使用说明书中。5.3.4 程序汇总表的编写5.3.4.1 程序汇总表是对电子设备中所有程序(包括可编程器件配置文件)在设备中配置情况的具体描述,供组织和管理

    2、生产使用。程序汇总表的填写,有以下规定:a) “软件标识或编号”栏填写程序的标识(包括产品代号、版本号和密级代号)或可编程器件的S整件的编号(包括版本号和密级代号)。当多个CSCI或CSC或CSU合装在一个固件中时,除在首栏填写组合程序的标识外,还需在其下栏填写每个CSCI或CSC或CSU的标识;b) “名称”栏填写各程序的功能名称;c) “编号”栏填写各程序装入的固件所在的SP整件编号(所有装有程序的硬件需编制SP整件);d) “位置代号”栏填写SP整件所在系统中的位置;e) “种类代号”栏填写固件所在电路中的种类代号;若一个程序分开装入二个以上固件时,应在相应栏内填写各固件所在电路中的种类

    3、代号;f) “整机工作令号”填写整机产品的工作令号和台(套)号,如第二批960产品共十套,其第一套的整机工作令号填写960-023-10-1:。如果本程序汇总表中包括其它软件产品、且该软件产品有单独的汇总表时,则该软件产品汇总表中的程序不再汇入本汇总表,需在本汇总表末尾加以引述,如:“成套软件产品的程序汇总表见CFDZ1.231.011RH”。5.3.4.2 单元或分系统的程序汇总表可以将可编程逻辑器件的S整件汇总表和软件的程序汇总表分别汇总提交给总体,也可以合并汇总在一份汇总表中。5.3.4.3 提交归档的程序汇总表应包括可编程逻辑器件的S整件和软件的程序。程序汇总表整机工作令号序号软件标识

    4、或编号程序装入SP整件文件号名称编号位置代号种类代号备注更改附录A(规范性附录)软件文档编写提示各文档的内容、结构层次划分可按本提示和正文5.3.2条的规定编写。A.1 软件质量保证计划编写提示1 目的本计划的目的在于对所开发的,软件规定各种必要的质量保证措施,以保证交付的,软件能够满足项目委托单位的各种需求,能够满足开发任务书规定的各项具体需求。2.引用文件按文档号和标题列出本文档引用的所有文档。3 软件质量保证机构与职责4 软件质量控制程序和要求4.1 软件评审4.2 软件文档管理4.3 软件配置管理4.4 软件更改管理4.5 软件的测试、验收4.6 外购、外协软件的质量控制根据需要而定4

    5、.7 质量记录的收集、维护和保存 描述准备计划、维护、评审和执行软件质量保证活动的记录。标识要使用的格式和要记录的信息。4.8 软件的维护A.2 系统分析和段设计文件编写提示1.1 标识列出本文档的:a) 已批准的标识号;b) 标题;c) 缩略语;d) 本文档适用的系统;e) 由系统设计所派生需求的更高层的规格说明。1.2 概述概述本文档所适用的系统和CSCI的用途。1.3 文档概述概述本文档的用途和内容。2 引用文档3 运行概念分节描述系统的运行概念。3.1 任务3.1.1 用户要求描述系统必须满足的用户要求,并引用描述这些要求的文档。3.1.2 主要任务描述系统的主要任务。3.2 支持环境

    6、描述在系统生产和部署阶段所需的支持环境。3.2.1 支持硬件 描述系统正常运行需要的硬件环境。3.2.2 支持软件 描述系统正常运行需要的软件环境。3.4 系统体系结构描述系统的内部结构,标识子系统、HWCI和CSCI,并概述其用途。描述子系统、HWCI和CSCI之间的关系。标识和陈述系统每个内部接口的用途,用系统体系结构框图表示系统顶层的体系结构。3.5 运行情况描述系统的每一种运行情况。对每个系统状态和方式,应标识其执行的配置项和执行的手工操作,也可以用图表表示。此外,还应描述系统以不同的状态和方式运行时,配置项之间执行的控制流程和数据流程。4 系统设计本章应标识系统内部被指定为主要项目或

    7、关键项目的HWCI。分小节标识系统的每个HWCI、CSCI和手工操作,还应描述系统内部HWCI、CSCI和手工操作之间的关系,也可用树型框图描述配置项之间的关系。4.1 HWCI标识分小节描述分配给每个HWCI的系统需求。4.1.X (HWCI名称和项目唯一标识号)从4.1.1节开始编号,用名称和项目唯一标识号标识-HWCI,并陈述它的用途。标识由系统和段规范分配给HWCI的每个需求,标识由HWCI决定的每个系统功能的名称和项目唯一标识号。系统的每个外部接口都要用标准术语(如:输入/输出电压、维数、冗余度、负载、速度等)详细描述,并描述HWCI的设计约束。4.2 CSCI标识分小节描述分配给每

    8、个CSCI的系统需求。4.2.X (CSCI名称和项目唯一标识号)从4.2.1节开始编号,用名称和项目唯一标识号标识CSCI,并陈述它的用途。标识由系统和段规范分配给CSCI的每个需求,标识由HWCI决定的每个系统功能的名称和项目唯一标识号。系统的每个外部接口都要用标准术语(如:位/秒、字长、消息格式、消息频率、优先权规则、协议等)详细描述。并描述CSCI的设计约束。4.3 手工操作标识分小节描述分配给每个手工操作的系统需求。4.4 内部接口分节描述系统内部每个接口及其系统中接口与配置项之间关系,并可以引用系统内部接口框图。4.4.X (接口名称和项目唯一标识号)从4.4.1节开始编号,用名称

    9、和项目唯一标识号标识系统内部所有的接口,标识模块间传输的每个信号。5 处理资源分小节描述系统的处理资源。5.X (处理资源名称和项目唯一标识号)从5.1节开始编号,用名称和项目唯一标识号标识处理资源、系统使用的配置项。对每个处理资源要指定其使用特性。例如对计算机硬件还应定义下列特征:a) 内存大小:计算机内部存储器(独立、共享或全部)的大小;b) 字长:每个计算机字的位数;c) 处理速度:计算机处理器能力(独立、共享或全部)(如在全部配置运行时有的余量);d) 字符集标准:Unicodee) 中断能力:硬件的中断能力;f) 直接存储器访问(DMA):DMA的数据传输;g) 辅助存储器:辅助存储

    10、器容量(独立、共享或全部);h) 其他;6.质量因素的考虑根据情况,分小节指明质量因素和质量度量的模型,包括相关的评价标准。A.3 软件开发计划编写提示1.1标识引出本文档的:d) 本文档适用的计算机软件配置项(CSCI)。并标明CSCI的标题、缩写和标识号。1.4 与其它计划的关系概述本计划与其它项目开发计划的关系。3 软件开发管理分节描述与软件开发管理活动相关的计划。3.1 项目组织与资源分小节叙述承制方的项目组织和项目资源。3.1.1 承制方的设施叙述用于完成合同的设施。醒目地标出安全保密范围和简述安全保密活动的特点。还要醒目标出特定的资源,如:软件工程环境。3.1.2 管理部门提供的设

    11、备、软件和服务描述为完成合同要求由管理部门提供的所有设备、软件、服务和设施,其中包括何时需要的详细进度表。要醒目的标出在系统规范、主要项目或关键项目开发说明中未列出的但要求的项目。3.1.3 组织机构概述承制方软件项目组织机构。标识每个组织的权限和职责,可以用图表来表示此信息。3.1.4 人员描述完成软件开发项目必须的人员数量,指明项目管理、软件工程、正式软件测试、软件产品评价、软件配置管理以及本计划标识的其它功能分别所需的人员数目及总数。3.2 进度和里程碑3.2.1 活动以承制方主要进度表为基础,简要的叙述项目的每个软件开发活动及其相应的进度。开发进度还应指明所有的重要事件,如评审、审查、

    12、关键会议等等。进度表可以用图表提供。对每一个活动,进度表应标出:a) 活动的起始点;b) 正式和非正式文档的草稿和最终拷贝的编写起止日期;c) 活动完成点;d) 高风险区域。3.2.2 活动网络描述项目活动中的顺序关系,标出完成项目对活动要求的最长时间和完成的时间余量。这些信息可以用图表提供,例如采用-./0 图。3.2.3 来源标识标识并描述软件开发所需资源(软件、固件和硬件)的来源。提供一份获得所需资源的计划,并且应说明要求的日期和每个资源项应如何使用。3.3 风险管理描述为成功完成项目而对风险区域进行管理的计划。包括:a) 标识项目的风险区域并确定各风险区的优先级;b) 标识引起风险的因

    13、素;c) 将监控风险因素和减少风险发生的措施和计划编写成文档;d) 标识与每个风险区域有联系的规程。3.4 安全保密描述承制方为实现合同的安全保密性要求而制定的计划。3.5 与其它承制方的接口描述为保证与有关的承制方的兼容性所作的协调设计和数据管理的工作。3.6 与其它软件独立验证与确认机构的接口描述与软件独立验证与确认机构的接口。3.7 转承制方的管理描述对转承制方的管理。3.8 正式审查描述承制方准备和提交正式审查的内部程序。3.9 软件开发库描述承制方用来控制软件和有关文档的软件开发库。3.10 纠正过程描述实施的纠正工作过程。3.11 问题/更改报告描述使用的问题/更改报告的格式。这些

    14、报告用于记载检测到的软件及其文档的问题,并且记述解决这些问题需要做的纠正工作。报告包括下列数据选项:a) 系统或项目名称:本报告应用的系统或开发项目名称;b) 编制者:提交本报告的人或机构的名字和电话号码;c) 问题号:指定的问题编号;d) 问题名称;e) 涉及的软件元素或文档:本报告应用的特定软件元素、文档小节号,包括配置标识和版本号;f) 编制日期:报告首次提交的日期;g) 类型和优选次序;h) 问题描述:问题和产生此问题的条件、输入和设备配置的描述。导致问题发生的活动。允许复制和分析的问题信息与其它要报告的问题和修改的关系;i) 分析者:姓名、电话号码和单位;j) 委派日期:委派分析者的

    15、日期;k) 完成日期:完成分析的日期;l) 分析时间:分析问题要求的时间;m) 建议方案:问题分析后的建议方案。并简要描述建议方案的特点,基本原理和测试结果;n) 影响:方案采纳后对费用、进度和接口的影响。方案未采纳时,对性能、其它系统、配置项、其它承制方、系统使用者、集成后的后勤保障、系统资源和训练等的影响;o) 问题状态:由配置控制程序决定的问题状态;p) 方案的批准者:由配置控制权限任命;q) 所起的作用:问题解决后带来的作用;r) 校对者:姓名、电话号码和委派机构;s) 校对日期;t) 版本号:问题校对的版本;u) 校对时间:校对问题需求的时间;v) 实现方案:简述解决问题方案。4 软

    16、件工程分节描述与软件工程相关的活动。4.1 组织和资源分小节描述软件工程活动所必须的组织、责任和资源。4.1.1 组织机构描述负责执行软件工程活动的组织,包括每个组织的权限和责任,以及与其它组织实体的关系,如负责执行软件质量评价的组织。如果不止一个组织,每个组织的结构、人员和资源以及他们内部之间的关系也要醒目的标出。4.1.2 人员描述执行软件工程活动的人员数量和技术水平(包括职务和职称),并说明特定岗位的需求,如地理位置、安全保密级别等。4.1.3 软件工程环境分小节标识和描述执行软件工程活动所需的资源(软件、固件和硬件)的建立和维护的计划。4.1.3.1 软件项标识执行软件工程活动所必须的

    17、软件项,如操作系统、编译器、代码检查器、动态路径分析器、测试驱动器、预处理器、测试数据产生器、后置处理器等。描述每个项目的目的,并标识与软件项相关的分类和安全保密性问题。4.1.3.2 硬件和固件项标识用于软件工程环境的计算机硬件、接口设备和固件项。描述每一项的目的,并标出与硬件和固件项相关的分类和安全保密性问题。4.1.3.3 权限标识出与软件工程环境每个项目相关的所有权和管理机构或使用者的权限。4.1.3.4 安装、控制和维护制定安装和测试每个软件工程环境项目的计划,描述控制和维护每个软件工程环境项目的计划。4.2 软件标准和研制程序分小节描述计划使用的软件标准和研制程序。4.2.1 软件

    18、开发技术和方法标识和描述计划执行的技术和方法:a) 软件需求分析;b) 概要设计;c) 详细设计;d) 编码和CSU测试;e) CSU集成和测试;f) CSCI测试。4.2.2 软件开发文件定义承制方的计划,包括对软件开发文件的创立和维护负有责任的组织机构,定义软件开发文件的格式和内容,描述维护软件开发文件的程序。4.2.3 设计标准描述在软件开发中计划使用的设计标准。4.2.4 编码标准描述在开发软件中计划使用的编码标准。4.3 非开发软件标识并描述每一个准备组合到交付软件中的非开发软件项,如:商品软件、重用软件、管理机构或使用方提供的软件,并简要描述每一个非开发软件项的基本原理。5 正式合

    19、格性测试分小节描述与正式合格性测试活动有关的计划。5.1 组织机构和资源分小节描述正式合格性测试所需的组织和资源。5.1.1 组织机构描述负责执行正式合格性测试的组织。包括组织的权限和责任,以及与其它组织实体的关系,如负责执行软件工程的组织。5.1.2 人员描述执行正式合格性测试的人员数量和技术水平(包括职务和职称),并说明特定岗位的需求,如地理位置、安全保密级别等。5.2 测试方法/基本原理描述执行正式合格性测试的方法和基本原理。5.3 测试计划的假设条件和约束描述测试计划中所作的假设条件和签约机构对正式合格性测试施加的约束。6 软件产品评价分节描述与软件产品评价活动相关的计划。6.1 组织

    20、机构和资源分小节描述软件产品评价所需的组织和资源。6.1.1 组织机构描述负责执行软件产品评价的组织,包括每个组织的权限和责任,以及与其它组织实体的关系,如负责执行软件工程的组织,如果不止一个组织,每个组织的结构、人员和资源以及他们内部之间的关系也要醒目的标出。6.1.2 人员描述执行软件产品评价人员的数量和技术水平(包括职务和职称),并说明特定岗位的需求,如地理位置、安全保密级别等。6.2 软件产品评价规程和工具分节描述软件产品评价的规程和使用的评价工具。6.2.1 评价规程描述用于评价软件和相关文档的规程。6.2.2 评价工具标识并描述软件产品评价中使用的工具。工具的描述要说清楚该工具在评

    21、价过程中的用途。为减少重复可引用软件工程和软件测试环境中使用的工具。6.3 转承制方的产品描述为评价转承制方的需求是否满足以及评价转承制方产品而制定的计划和规程。6.4 软件产品评价记录描述准备和维护每个产品评价记录的计划,标识使用的格式和每个评价记录的信息,并描述维护记录和便于管理机构审查所制定的计划。6.5 依赖活动的产品评价分小节描述执行每个软件开发产品的产品评价的计划。本节还要说明任何计划修改的或GJB2786要求之外的评价标准,并列出在每个软件开发活动中安排进行的产品评价(开发活动指,系统要求分析/设计、软件需求分析、概要设计、详细设计、编码和CSU测试、CSC集成和测试、CSCI测

    22、试,以及系统集成与测试)。6.5.X 软件产品评价(活动名)从6.5.1节开始编号,描述在每一活动中安排的评价计划,并标识指定的被评价产品、使用的评价标准、评价程序和工具。对软件开发计划中进行评价的项目,要指定取样方法和被评价项目所占的比率。7 软件配置管理分节描述与软件配置管理活动相关的计划。7.1 组织机构和资源分小节描述软件配置管理所需的组织和资源。7.1.1 组织机构描述负责执行正式合格性测试组织。包括每个组织的权限和责任,以及与其它组织实体的关系,如负责执行软件工程的组织。7.1.2 人员描述执行软件配置管理的人员的数量和技术水平(包括职务和职称),并说明特定岗位的需求,如地理位置、

    23、安全保密级别等。7.2 配置标识7.2.1 开发配置标识标识CSCI开发所使用的承制方内部开发配置。并描述每个标识的开发配置的内容及建立方法。7.2.2 标识方法描述标识(如:起名字、作标号、作编号)及修改CSCI、CSC、CSU和文档的方法。描述怎样对要标识的CSCI、CSC、CSU和文档作修订。7.3 配置控制分小节详细描述用于控制开发配置和内部控制的文档,及维护开发配置和内部控制的文档的规程。7.3.1 配置控制流程描述提交、审查和是否赞同问题及其修改的过程(见图1)。图1 配置控制流程示例7.3.2 报告的文档分小节描述和引用报告的文档。例如,用于控制软件问题及其更改的通知单和工程更改

    24、建议。7.3.2.X 报告名称从7.3.2.1节开始编号- 描述或引用要完成的报告的格式、内容和指令。7.3.3 审查规程分小节描述与配置控制流程相关的审查部门的目的及其所使用的审查规程。7.3.3.X 审查委员会名称/规程从7.3.3.1节开始编号-描述审查委员会的目的和遵守的规程。描述审查委员会如何与配置标识模式联接,以提供历史的可追踪性。7.3.4 项目介质的存储、处置和交付描述在开发过程中,要交付软件及文档的存储、处置和交付的正式规程。7.3.5 其它控制标识上面未讨论的其它配置控制活动。7.4 配置状况报表定义使用的配置状况报表系统。并描述状况记录和报告的内容、格式和用途。7.5 配

    25、置审核描述承制方保障和执行配置审核计划。在执行审核中,也要描述如何使用配置状况报告和记录。7.6 认可规格说明的准备描述承制方准备以及响应认可规格说明的规程。a) 把规格说明提交鉴约机构进行审查和认可;b) 确保体现已批准的更改;c) 更改配置状况报表的报告已反应批准的基线。7.7 配置管理主要里程碑标识为满足合同要求,与软件配置管理相关的内部的里程碑或管理机构的里程碑。8 其它软件开发功能分节描述包括在软件开发中的其他承制方的功能。8.X (功能名)从8.1节开始编号,描述要执行的功能。描述执行此功能所需的组织机构、资源以及方法与规程。8.X.1 组织机构(功能名)从8.1.1开始编号,描述负责执行此功能的组织。包括每个组织的权限和职责,以及与其他组织实体,如执行配置管理职责的组织的关系。如果包括一个以上组织,那么每个组织结构和资源,以及他们之间的关系要醒目地标出。8.X.2 人员(功能名)描述执行此功能的人员的数量和技术水平。人员的描述要有职务和职称。此外,还要说明特定岗位的需求,如地理位置、安全保密级别等。8.X.3 其它资源(功能名)标识和描述执行此功能所必需的任何其它资源。对每个资源,要简要描述其功能。8.X.4 方法和规程(功能名)描述执行此功能所使用的方法和规程。A.4 软件设计与编码规范1 适用范围概述本文档适用的系统或CSCI。列出本文档引用的所有文


    注意事项

    本文(软件文档编写规定Word格式.docx)为本站会员主动上传,冰豆网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对上载内容本身不做任何修改或编辑。 若此文所含内容侵犯了您的版权或隐私,请立即通知冰豆网(点击联系客服),我们立即给予删除!

    温馨提示:如果因为网速或其他原因下载失败请重新下载,重复下载不扣分。




    关于我们 - 网站声明 - 网站地图 - 资源地图 - 友情链接 - 网站客服 - 联系我们

    copyright@ 2008-2022 冰点文档网站版权所有

    经营许可证编号:鄂ICP备2022015515号-1

    收起
    展开