[计算机]软件文档写作11-管理文档

《[计算机]软件文档写作11-管理文档》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、第七章软件管理文档7.1管理文档概述工程化的软件生产方式是软件业界始终在不懈追求的目标。软件项目管理方法适用与否，对软件项目的成败有着举足轻重的作用。而软件项目管理方法改进的途径之一，就是建立行之有效、可操作性强的软件管理文档。软件管理文档项目开发计划测试计划测试分析报告开发进度报告开发总结报告管理文档的组成：管理文档有以下几个方面的作用：维护人员软件开发管理人员软件开发人员软件操作人员用户软件管理文档管理文档的作用主要体现在3个方面：①是软件开发各阶段工作成果的体现；②把软件开发过程中的一些“不可见”的事物转换成“可见”的文字资料；③提供了管理人员、开发人员、操作人员和用户之间相互沟通、协调

2、的窗口。17.2项目开发计划项目开发计划又称软件定义文档，是和软件本身一样重要的知识资产，是项目启动后第一件最重要的工作。项目开发计划一般包括资源需求、工作分解、工作目标、开发团队及人员安排、进度安排、内外接口约定、风险分析以及软件质量控制机制等。1.项目开发计划书项目开发计划书的具体内容随着项目和开发机构类型的不同而不同，一般都会包括以下几个部分：①项目目标。简述项目目标，并列出影响管理的约束条件，如预算、时间…②开发团队及人员安排。阐述团队组织方式、人员构成及分工③软硬件资源需求。分析和列出所需资源，注明估算的资源需要时间及价格④工作分解。分解项目为一系列活动，确定项目里程碑及可交付文档⑤

3、项目进度。描述项目各活动之间的依赖关系、到达里程碑的时间等⑥风险分析。分析项目可能存在的风险、发生的可能性及应对风险的策略⑦监控机制。制定详细、可操作的项目监控机制，明确管理报告的递交时间⑧开发估算。包括规模、工作量、成本等的估算，要求依据并积累历史数据制定项目开发计划的过程被称为项目策划。由于计划所具有的在时间上的提前性，项目开发计划通常会经常性的修正，有些部分甚至会频繁的改变！而部分内容的变化，会影响开发计划的正确性和符合性，使其越来越偏离项目实际，最后变得没有价值。如随着项目需求的逐渐明确引起的项目计划细化、项目可提供资源变化引起的项目计划的变化等。所以，在实际工作中，需要有明确的责任人

4、和操作原则，来对项目计划实施维护，并对项目计划的变更实施必要的控制。另一个重要的方面是，在组织文档时，就要考虑到这种频繁变更的需要，使得当变更发生时，文档的相应部分能够容易替换。22.工作分解结构工作分解结构(workbreakdownstructure,WBS)是对整个项目工作的分级描述，是项目计划开发的第一步。分解示意如下图所示。目标活动活动活动活动活动活动1级2级……m级工作包任务1任务2任务3…任务n活动工作分解结构设计一般可以采用2种方法：-自上而下的方法。从项目的目标开始，逐步分解，直到具体任务；-自下而上的方法。也称集思广益法。即从底层开始，逐层集成，最后汇合后完成目标。工作分解

5、结构主要有4个用途：思路工具：可以描述项目的整体思路，是一个计划和设计的工具；结构设计工具：是项目工作的结构图，可以清晰表达项目各项工作间的相互关系；计划工具：能够展示项目全貌，说明为完成项目所需完成的各项活动；项目状态报告工具：可以作为项目状态报告的框架。随着低一级项目活动的完成，项目由下而上不断整合，某一项工作的完成将成为里程碑，所以，工作分解结构就定义了里程碑事件。33.项目里程碑与阶段性文档由于软件产品是无形的，因此，管理者需要通过文档的形式获得信息，了解软件的开发状况，以作出管理的决定。里程碑的建立，可以描述软件开发活动一个过程的终结。在每个里程碑，都有一个正式的可以提交给管理层的阶

6、段性结果。比如，一份报告。里程碑报告的内容不拘，以能清楚说明阶段性结果为标准，应能代表项目中一个特定逻辑意义上的阶段的终结。要建立里程碑，软件过程就一定要分解成一系列相关的基本活动，而每个基本活动都要有相应的输出结果。如下图，是一个需求描述中的活动，其中每个活动都有主要输出。可行性研究可行性研究可行性研究可行性研究可行性研究可行性报告用户需求估算报告体系结果设计系统需求44.项目进度项目管理者要求估算完成各项活动所需的时间和资源，并将它们严密的组织起来，以安排项目进度。不同的项目，具有不同的项目开发进度。初始的项目进度安排往往是不精确的，但随着项目进展信息的不断增多，进度安排也会越来越接近项目

7、实际进度，因此，必须不断更新项目进度。项目进度包括将一个项目分解为若干独立的活动，以及判断完成这些活动所需的时间。通常，有些活动是可以并行的，项目管理者应组织并协调这些并行的工作。项目进度过程见下图：识别活动识别活动依赖关系估算活动的资源为活动分配资源创建项目图表软件需求活动图表及条形图在进度估算时，管理者需要有一定的余量。如项目难度大，则花费的时间也会较多。又如，项目个别开发人员可能发生的变动，