第2讲-软件工程标准化与文档幻灯片.ppt

(4) 完整性 任何一个文档都应当是完整的、独立的，它应自成体系。 例如，前言部分应做一般性介绍，正文给出中心内容，必要时还有附录，列出参考资料等。 同一课题的几个文档之间可能有些部分内容相同，这种重复是必要的。 不要在文档中出现转引其它文档内容的情况。如，一些段落没有具体描述，用“见××文档××节”的方式. * (5) 灵活性 各个不同软件项目，其规模和复杂程度有着许多实际差别，不能一律看待。 应根据具体的软件开发项目，决定编制的文档种类。 软件开发的管理部门应该根据本单位承担的应用软件的专业领域和本单位的管理能力，制定一个对文档编制要求的实施规定。 * 对于一个具体的应用软件项目，项目负责人应根据上述实施规定，确定一个文档编制计划。其中包括： 编制哪几种文档，详细程度如何 决定方式可借鉴国外P69 （求和法和规模法） 各文档的编制负责人和进度要求 审查/批准负责人和时间进度安排 在开发时期内各文档的维护、修改和管理的负责人，以及批准手续 有关的开发人员必须严格执行这个文档编制计划。 * 当所开发的软件系统非常大时，一种文档可以分成几卷编写。例如， 项目开发计划可分写为： 质量保证计划 配置管理计划 用户培训计划 安装实施计划等。 系统设计说明书可分写为： 系统设计说明书 子系统设计说明书。 * 程序设计说明书可分写为： 程序设计说明书 接口设计说明书 版本说明。 操作手册可分写为： 操作手册 安装实施过程。 测试计划可分写为： 测试计划 * 测试设计说明 测试规程 测试用例。 测试分析报告可分写为： 综合测试报告 验收测试报告。 项目开发总结报告也可分写成： 项目开发总结报告 资源环境统计。 * 应根据任务的规模、复杂性、项目负责人对该软件的开发过程及运行环境所需详细程度的判断，确定文档的详细程度。 对国标GB8567-2006《计算机软件文档编制规范》所建议的所有条款都 可以扩展，进一步细分，以适应需要； 如果条款中有些细节并非必需，也可以根据实际情况压缩合并。 * 程序的设计表现形式，可以使用程序流程图、判定表、程序描述语言(PDL)、或问题分析图(PAD)等。 对于文档的表现形式，没有规定或限制。可以使用自然语言、也可以使用形式化的语言或半形式化的语言。 当国标《计算机软件文档编制规范》中规定的文档种类不能满足某些应用部门的特殊需要时，可以建立一些特殊的文档种类要求，这些要求可以包含在本单位的文档编制实施规定中。 * 为使软件文档能 起到多种桥梁的作用 有助于程序员编制程序 有助于管理人员监督和管理软件的开发 有助于用户了解软件的工作和应做的操作， 有助于维护人员进行有效的修改和扩充 文档的编制必须保证一定的质量。 * 软件工程标准与软件文档 软件工程标准 软件工程标准的层次 中国的软件标准 软件文档的作用与分类 软件文档的质量要求 * 什么是软件工程标准 软件危机的出路在于软件开发的工程化和标准化。 程序设计语言的标准化：为某一程序设计语言规定若干个标准子集，对于语言的实现者和用户都带来了很大方便。 软件过程的标准化：软件生存期各个阶段的工作建立标准或规范 * 软件工程标准的类型 国家标准GB／T 15538－1995《软件工程标准分类法》给出软件工程标准的分类。 涉及过程管理、产品管理、资源管理，以及确认与验证 * 软件工程标准的类型(续) 过程标准 方法、技术、度量 产品标准 需求、设计、部件、描述、计划、报告 专业标准 职业、道德准则、认证、特许、课程 记法标准 术语、表示法、语言 * 软件工程标准的清单可用二维表表示。 (P2 表1.1,1.2) 表中填入的标准表明了软件工程标准的工作范围和如何对标准分类。 已经制定的标准都可在表中找到相应的位置，而且它可启发人们去制定新的标准。 * 软件工程标准化的作用 可提高软件的可靠性、可维护性和可移植性； 可提高软件人员的技术水平，减少差错和误解； 可提高软件人员之间的通信效率，提高软件的生产率； 有利于软件管理；有利于降低软件产品的成本和运行维护成本； 有利于缩短软件开发周期。 * 软件工程标准的层次 (1) 国际标准 由国际联合机构制定和公布，提供各国参考的标准。 国际标准化组织 ISO (International Standards Organization) ISO建立了“计算机与信息处理技术委员会”, 简称ISO／TC97，专门负责与计算机有关的标准化工作。 如： ISO 8631－86 Information processing_program constructs and