《软件工程实用教程》第10章软件工程标准与文档.ppt

第第10章章 软件工程标准与文档软件工程标准与文档 本章学习内容：本章学习内容：1 1掌握软件工程标准的层次、类型掌握软件工程标准的层次、类型等概念等概念2 2明确软件文档的编写要求明确软件文档的编写要求3 3熟悉软件文档的主要内容熟悉软件文档的主要内容4 4理解软件文档的重要作用理解软件文档的重要作用 第第10章章 软件工程标准与文档软件工程标准与文档10.1 10.1 软件工程标准软件工程标准 10.1.1 10.1.1 软件工程标准软件工程标准 专业基础标准（软件工程术语，流程图，系统配置图专业基础标准（软件工程术语，流程图，系统配置图软件开发与文档编制（软件生存期过程，软件生存期过软件开发与文档编制（软件生存期过程，软件生存期过程使用指南，配置管理，维护）程使用指南，配置管理，维护）软件质量保证（软件质量保证计划，软件质量特性，内软件质量保证（软件质量保证计划，软件质量特性，内部度量，外部度量）部度量，外部度量）软件产品评价（软件产品评价（ISO/IEC 14598ISO/IEC 14598系列标准）系列标准）软件过程评估（软件过程评估（ISO/IEC 15504ISO/IEC 15504系列标准）系列标准）软件质量体系与认证（软件质量体系与认证（ISO9000ISO9000系列标准）系列标准）软件能力评估（软件能力成熟度模型，关键惯例，过程软件能力评估（软件能力成熟度模型，关键惯例，过程剪裁和软件能力成熟度模型，成熟度模型评估框架）剪裁和软件能力成熟度模型，成熟度模型评估框架）CASECASE工具工具第第10章章 软件工程标准与文档软件工程标准与文档10.1.2 10.1.2 软件工程标准的层次软件工程标准的层次 1 1国际标准国际标准2 2国家标准国家标准 3 3行业标准行业标准 4 4企业规范企业规范 5 5项目规范项目规范 第第10章章 软件工程标准与文档软件工程标准与文档10.1.3 10.1.3 软件工程国家标准软件工程国家标准 GB/T16260-1996GB/T16260-1996 信息技术信息技术 软件产品评价软件产品评价 质量特性质量特性及其使用指南及其使用指南GB/T17544-1998GB/T17544-1998 信息技术信息技术 软件包软件包 质量要求和测试质量要求和测试GB/T8567-1988GB/T8567-1988计算机软件产品开发文件编制指南计算机软件产品开发文件编制指南GB/T9385-1988GB/T9385-1988计算机软件需求说明编制指南计算机软件需求说明编制指南GB/T9386-1988GB/T9386-1988计算机软件测试文件编制规范计算机软件测试文件编制规范GB/T11457-1995GB/T11457-1995 软件工程术语软件工程术语GB/T12504-1990GB/T12504-1990 计算机软件质量保证计划规范计算机软件质量保证计划规范GB/T12505-1990GB/T12505-1990 计算机软件配置管理计划规范计算机软件配置管理计划规范GB/T13423-1992GB/T13423-1992 工业控制用软件评定准则工业控制用软件评定准则GB/T13502-1992GB/T13502-1992 信息处理信息处理 程序构造及其表示的约定程序构造及其表示的约定GB/T13702-1992GB/T13702-1992 计算机软件分类与代码计算机软件分类与代码GB/T14079-1993GB/T14079-1993 软件维护指南软件维护指南第第10章章 软件工程标准与文档软件工程标准与文档 GB/T14085-1993 GB/T14085-1993信息处理系统信息处理系统 计算机系统配置图符计算机系统配置图符号及约定号及约定GB/T14394-1993GB/T14394-1993 计算机软件可靠性和可维护性管理计算机软件可靠性和可维护性管理GB/T15532-1995GB/T15532-1995 计算机软件单元测试计算机软件单元测试GB/T15535-1995GB/T15535-1995 信息处理信息处理 单命中判定表规范单命中判定表规范GB/T15538-1995GB/T15538-1995 软件工程标准分类法软件工程标准分类法GB/T15697-1995GB/T15697-1995 信息处理信息处理 按记录组处理顺序文卷的按记录组处理顺序文卷的程序流程程序流程GB/T15853-1995GB/T15853-1995 软件支持环境软件支持环境GB/T1526-1989GB/T1526-1989信息处理信息处理 数据流程图、系统流程图、数据流程图、系统流程图、程序网络图和系统资源图的文件编制符号及约定程序网络图和系统资源图的文件编制符号及约定GB/T16680-1996GB/T16680-1996 软件文档管理指南软件文档管理指南GB/T8566-1995GB/T8566-1995信息技术信息技术 软件生存期过程软件生存期过程第第10章章 软件工程标准与文档软件工程标准与文档10.2 10.2 软件文档与编写要求软件文档与编写要求 10.2.1 10.2.1 软件文档的含义软件文档的含义 软件文档也称文件，通常指的是一些记录的软件文档也称文件，通常指的是一些记录的数据和数据媒体，它具有相对稳定的特点，数据和数据媒体，它具有相对稳定的特点，可被人和计算机阅读。它和计算机程序共同可被人和计算机阅读。它和计算机程序共同构成了能完成特定功能的计算机软件。构成了能完成特定功能的计算机软件。 文档的作用：文档的作用： 第第10章章 软件工程标准与文档软件工程标准与文档10.2.2 10.2.2 软件文档的种类软件文档的种类 1 1开发文档开发文档 可行性研究和项目任务书；可行性研究和项目任务书；需求规格说明；需求规格说明；功能规格说明；功能规格说明；设计规格说明，包括程序和数据规格说明；设计规格说明，包括程序和数据规格说明；开发计划；开发计划；软件集成和测试计划；软件集成和测试计划；质量保证计划、标准、进度；质量保证计划、标准、进度；安全和测试信息。安全和测试信息。 第第10章章 软件工程标准与文档软件工程标准与文档2 2产品文档产品文档 培训手册；培训手册； 参考手册和用户指南；参考手册和用户指南； 软件支持手册；软件支持手册； 产品手册和信息广告。产品手册和信息广告。 3 3管理文档管理文档 第第10章章 软件工程标准与文档软件工程标准与文档10.2.3 10.2.3 软件文档的编写方法软件文档的编写方法 1 1编写原则编写原则 立足于读者；立足于读者；立足于实际需要；立足于实际需要；文字准确、简单明了。文字准确、简单明了。2 2编排原则编排原则所有文档都应编排得便于迅速查到所需要的内容；所有文档都应编排得便于迅速查到所需要的内容；采用由一般到具体的层次结构法；采用由一般到具体的层次结构法；可能的情况下还可以采用词汇之间的相互链接；可能的情况下还可以采用词汇之间的相互链接；应使图表放在它所理解的文字附近，以便阅读正应使图表放在它所理解的文字附近，以便阅读正文的同时也看到图表；文的同时也看到图表；适当使用不同的字体和版式，以增加一段正文的适当使用不同的字体和版式，以增加一段正文的明晰度。明晰度。第第10章章 软件工程标准与文档软件工程标准与文档3词汇与索引词汇与索引 技术术语的使用应该适当控制，避免滥用；技术术语的使用应该适当控制，避免滥用； 使用技术术语前要准确定义每个术语；使用技术术语前要准确定义每个术语； 每种文档均应该有一个词汇表和索引。每种文档均应该有一个词汇表和索引。 第第10章章 软件工程标准与文档软件工程标准与文档10.2.4 10.2.4 软件文档的质量要求软件文档的质量要求（1 1）针对性）针对性 （2 2）精确性）精确性 （3 3）清晰性）清晰性 （4 4）完整性）完整性 （5 5）灵活性）灵活性 （6 6）可追溯性）可追溯性