MIS新编-第6章6-2.ppt

3. 文件的扩展 当被开发系统的规模非常大时，一种文件可以分成几卷编写，可以按其中每一个系统分别编制，也可以按内容划分成多卷，例如： 项目开发计划可能包括质量保证计划、配置管理计划、用户培训计划和安装实施计划等。 系统设计说明书可分写成系统设计说明书和子系统设计说明书。 6.2.4 文件内容的灵活性 程序设计说明书可分写成程序设计说明书、接口设计说明书和版本说明等。 操作手册可分写成操作手册、安装手册等。 测试计划可分写成测试计划、测试设计说明、测试规程和测试用例等。 测试分析报告可分写成综合测试报告、验收测试报告等。 6.2.4 文件内容的灵活性 4. 节的扩张与缩并 GB/T8567-1988所建议的所有各条都可以扩展，可以进一步细分，以适应实际需要。反之，如果章条中的有些细节并非必需，也可以根据实际情况缩并。 6.2.4 文件内容的灵活性 5. 程序设计的表现形式 程序的设计表现形式可以是流程图、判定表，也可以使用其他表现形式，如程序设计语言 (PDL) 、问题分析图 (PAD) 等。 6. 文件的表现形式 对于文件的表现形式没有规定或限制，可以使用自然语言，也可以使用形式化语言。 6.2.4 文件内容的灵活性 7. 文件的其他种类 当GB/T8567-1988中所规定的文件种类尚不能满足某些应用部门的特殊需要时，可以建立一些特殊的文件种类要求，例如软件质量保证计划、软件配置管理计划等，这些要求可以包含在本单位的文件编制实施规定中。 6.2.4 文件内容的灵活性 《计算机软件产品开发文件编制指南》(GB/T8567-1988) 给出的14种软件文件的编制提示，同时也是这14种文件编写质量的检验准则。 6.2.5 文件编制的质量要求 为了使软件文件能起到前面所提到的多种桥梁作用，使它有助于程序员编制程序、有助于管理人员监督和管理软件开发、有助于用户了解软件的工作和应做的操作、有助于维护人员进行有效的修改和扩充，文件的编制必须保证一定的质量。 6.2.5 文件编制的质量要求 质量差的软件文件不仅使读者难于理解，给使用者造成许多不便，而且会削弱对软件的管理 (管理人员难以确认和评价开发工作的进展) ，提高软件的成本 (一些工作可能被迫返工)，甚至造成更加有害的后果 (如误操作等) 。 6.2.5 文件编制的质量要求 高质量的文件应当体现在以下一些方面： 1) 针对性：文件编制以前应分清读者对象，按不同类型、不同层次的读者，决定怎样适应他们的需要。例如，管理文件主要是面向管理人员的，用户文件主要是面向用户的， 这两类文件不应象开发文件 (面向软件开发人员) 那样过多使用软件的专业术语。 6.2.5 文件编制的质量要求 2) 精确性：文件的行文应当十分确切，不能出现多义性的描述。同一课题若干文件内容应该是协调一致，没有矛盾的。 3) 清晰性：文件编写应力求简明，如有可能，配以适当图表，以增强其清晰性。 6.2.5 文件编制的质量要求 4) 完整性：任何一个文件都应是完整的、独立的，它应自成体系。例如，前言部分应作一般性介绍，文本给出中心内容，必要时还有附录，列出参考资料等。同一课题的几个文件之间可能有些部分相同，这些重复是必要的。例如，同一项目的用户手册和操作手册中关于本项目功能、性能、实现环境等方面的描述是没有差别的。特别要避免在文件中出现转引其他文件内容的情况。比如，一些段落并未具体描述，而用“见××文件××节”的方式，这将给读者带来许多不便。 6.2.5 文件编制的质量要求 5) 灵活性：各个不同的软件项目，其规模和复杂程度有着许多实际差别，不能一律看待。 6) 可追溯性：由于各开发阶段编制的文件与各阶段完成的工作有着紧密的关系，前后两个阶段生成的文件，随着开发工作的逐步扩展，具有一定的继承关系。在一个项目各开发阶段之间提供的文件必定存在着可追溯的关系。例如，某一项软件需求，必定在设计说明书，测试计划甚至用户手册中有所体现。必要时应能做到跟踪追查。 6.2.5 文件编制的质量要求 在整个软件生存周期中，各种文件作为半成品或是最后成品，会不断地产生、修改或补充。为了最终实现产品的高质量，必须加强对文件的管理。文件的编制工作实际上贯穿于一项软件的整个开发过程，因此，对文件的管理必须贯穿于整个开发过程。 6.2.6 文件的管理和维护 1. 文件的形成 开发集体中的每个成员，尤其是项目负责人，应该认识到：文件是软件产品的必不可少的组成部分；在软件开发过程的各个阶段中，必须按照规定，及时地完成各种产品文件的编写工作；必须把在一个开发步骤中做出的决定和取得的结果及时地写入文件； 6.2.6 文件的管理和维护 开发集体必须及时地对这些文件进行严格的评审；这些文件的形成是各个阶段开发工作正式完成的标志。这些文件上