吕云翔 编著 14.ppt

14.2 软件文档 (1) 及时性。 在一个阶段的工作完成后，此阶段的相关文档应该及时地完成，而且开发人员应该根据工作的变更及时更改文档，保证文档是最新的。可以说，文档的组织和编写是不断细化、不断修改、不断完善的过程。 14.2 软件文档 (2) 完整性。 应该按有关标准或规范，将软件各个阶段的工作成果写入有关文档，极力防止丢失一些重要的技术细节而造成源代码与文档不一致的情况出现，从而影响文档的使用价值。 14.2 软件文档 (3) 实用性。 文档的描述应该采用文字、图形等多种方式，语言准确、简洁、清晰、易懂。 (4) 规范性。 文档编写人员应该按有关规定采用统一的书写格式，包括各类图形、符号等的约定。此外，文档还应该具有连续性、一致性和可追溯性。 14.2 软件文档 (5) 结构化。 文档应该具有非常清晰的结构，内容上脉络要清楚，形式上要遵守标准，让人易读、易理解。 (6) 简洁性。 切忌无意义地扩充文档，内容才是第一位的。充实的文档在于用简练的语言，深刻而全面地对问题展开论述，而不在于文档的字数多少。 14.2 软件文档 14.2 软件文档 (1) 可行性研究报告：说明该软件开发项目的实现在技术上、经济上和社会因素上的可行性，评述为了合理地达到开发目标可供选择的各种可能实施的方案。 (2) 项目开发计划：为软件项目实施方案制定出的具体计划，应该包括各项工作的负责人员、开发的进度、开发经费的预算、所需的硬件及软件资源等。 14.2 软件文档 (3) 软件需求规格说明书：也称软件规格说明书，是对所开发软件的功能、性能、用户界面及运行环境等做出的详细的说明。 (4) 概要设计说明书：是概要设计阶段的工作成果，它应说明功能分配、模块划分、程序的总体结构、输入/输出以及接口设计、运行设计、数据结构设计和出错处理设计等，为详细设计奠定基础。 14.2 软件文档 (5) 详细设计说明书：重点描述每一模块是怎样实现的，包括实现算法、逻辑流程等。 (6) 用户手册：详细描述软件的功能、性能和用户界面，使用户了解如何使用该软件。 14.2 软件文档 (7) 测试计划：为组织测试制定的实施计划，包括测试的内容、进度、条件、人员、测试用例的选取原则、测试结果允许的偏差范围等。 (8) 测试分析报告：是在测试工作完成以后提交的测试计划执行情况的说明。对测试结果加以分析，并提出测试的结论意见。 14.1.1 软件维护的过程 2. 用户提出维护申请并提交维护申请报告 当用户发现问题并需要解决时，首先应该向维护机构提交一份维护申请报告。申请报告中需要详细记录软件产品在使用过程中出现的问题，比如数据输入、系统反应、错误描述等。维护申请报告是维护人员研究问题和解决问题的基础，因此它的正确性、完整性是后续维护工作的关键。 14.1.1 软件维护的过程 3．维护人员确认维护类型并实施相应的维护工作 软件维护有多种类型，对不同类型的维护工作所采取的具体措施也有所不同。维护人员根据用户提交的申请报告，对维护工作进行类型划分，并确定每项维护工作的优先级，从而确定多项维护工作的顺序。 14.1.1 软件维护的过程 在实施维护的过程中，需要完成多项技术性的工作，比如： 对软件开发过程中相关文档进行更新； 对源代码进行检查和修改； 单元测试； 集成测试； 软件配置评审等。 14.1.1 软件维护的过程 4．整理维护记录并对维护工作进行评审 为了方便后续的维护评价工作，以及对软件产品运行状况的评估，需要对维护工作进行简单的记录。 14.1.1 软件维护的过程 维护的实施工作完成后，最好对维护工作进行评审。维护评审可以为软件开发机构的有效管理提供反馈信息，对以后的维护工作产生重要的影响。维护评审时，评审人员应该对以下问题进行总结。 14.1.1 软件维护的过程 在当前的环境下，设计、编码或测试的工作中是否还有改进的余地和必要？ 缺乏哪些维护资源？ 维护工作遇到的障碍有哪些？ 从维护申请的类型来看，是否还需要有预防性维护？ 14.1.1 软件维护的过程 5．对维护工作进行评价 当维护工作完成时，需要对维护工作完成的好坏进行评价。维护记录中的各种数据是维护评价的重要参考。如果维护记录完成得全面、具体、准确，会在很大程度上方便维护的评价工作。 14.1.1 软件维护的过程 14.1.2 软件维护的分类 14.1.3 软件的可维护性 14.1.4 软件维护的副作用 14.1 软件维护 14.1.2 软件维护的分类 根据维护工作的特征以及维护目的的不同，软件维护可以分为纠错性维护、适应性维护、完善性维护和预防性维护4种类型 14.1.2 软件维护的分类 纠错性维护是为了识别并纠正软件产品中所潜藏的错误，改正软件