第十三章    软件工程标准与文档   课后习题参考答案

一、简答题

（1）答：软件工作的范围从原来的只是使用程序设计语言编写程序，扩展到整个软件生存期。如软件概念的形成、需求分析、设计、实现、测试、制造、安装和检验、运行和维护直到软件引退(为新的软件所代替)。同时还有许多技术管理工作（如过程管理、产品管理、资源管理）以及确认与验证工作（如评审与审计、产品分析、测试等）常常是跨越软件生存期各个阶段的专门工作。所有这些方面都应逐步建立起标准或规范来。

（2）答：高质量的文档应体现在以下几个方面：

① 针对性：文档编制以前应分清读者对象。按不同类型、不同层次的读者，决定怎样适应他们的需要。例如，管理文档主要是面向管理人员的，用户文档主要是面向用户的，这两类文档不应该像面向开发人员的开发文档那样过多地使用软件的额专用术语。

② 精确性：文档的行文应当十分确切，不能出现多义性的描述。同一课题的几个文档的内容应当是协调一致，没有矛盾的。

③ 清晰性：文档的编写应力求简明，如有可能，配以适当的图表，以增强其清晰性。

④ 完整性：任何一个文档都应当是完整的、独立的，它应自成体系。例如，前言部分硬座一般性介绍，征文给出中心内容，必要时还有附录，列出参考资料等。还有，同一课题的几个文档之间可能有部分内容相同，这种重复是必要的。不要在文档中出现转引其他文档内容的情况。例如，一些段落没有具体描述，而用“见XX文档XX节”的方式，这将给读者带来许多不便。

⑤ 灵活性：各个不同软件项目，其规模和复杂程度有着许多实际差别，不能一律看待。

⑥ 可追溯性：由于各开发阶段编制的文档与各个阶段完成的工作有密切的关系，前后两个阶段生成的文档，随着开发工作的逐步延伸，具有一定的继承关系，在一个项目各开发阶段之间提供的文档必定存在着可追溯的关系。例如，某一项软件需求，必定在设计说明书、测试计划、甚至用户手册中有所体现。必要时应能做到跟踪追查。

（3）答：按照文档产生和使用的范围，软件文档大致可分为三类：

① 开发文档：这类文档是在软甲开发过程中，作为软件开发人员前一阶段工作成果的体现和后一阶段工作依据的文档。包括软件啊需求说明书、数据要求说明书、总体设计说明书、详细设计说明书、可行性研究报告、项目开发计划。

② 管理文档：这类文档是在软甲开发过程中，由软件开发人员制定的需提交管理人员的一些工作计划或工作报告。使管理人员能够通过这些文档了解软件开发项目安排、进度、资源使用和成果等。包括项目开发计划、测试计划、测试报告、开发进度月报及项目开发总结。

③ 用户文档：这类文档是软甲开发人员为用户准备的有关该软件使用、操作、维护的资料。包括用户手册、操作手册、维护修改建议、软件需求说明书。