任务:准备项目指南
此任务描述了如何准备特定于项目的指南。
用途

此任务的目的是:

  • 获取现有的指南或开发新指南,以供项目使用。
  • 使现有指南可由项目成员随需访问。
  • 与项目事务专家合作,根据使用者的反馈来更新这些指南。
关系
角色主要: 其他: 辅助:
输入必需:
可选: 外部:
输出
步骤
确定项目对指南的需求
目的: 确定项目需要哪些指南。

根据需要生成的工作产品以及每个工作产品所必需的正式程度,确定项目所需的一组指南。准备指南被视为定制项目流程的一部分,流程工程师将与项目经理一起花费相当多的时间来确定要向团队提供哪些类型的指南。

特定于项目的指南有几种用途,包括:

  • 就生成某些工作产品提供说明性的相关指导信息。
  • 确保工作产品开发一致,并遵循已定义的约定和风格。
  • 描述项目所需遵守的某些标准。
  • 为复审工作产品质量和完成情况的员工提供前导。

下表中描述了软件项目的一些最常注意到的指南。RUP 带有这些指南的示例,可用作特定于项目定制的起点。

指南的类型
所涉及的角色
生产者
消费者
业务建模指南
描述应如何对业务用例、业务工作者和业务实体建模。当项目需要正式对业务建模以构造新系统时,应考虑这些指南。业务流程重新设计的程度或业务流程的复杂程度规定了它们所需的全面程度。

业务流程分析人员 业务流程分析人员、业务设计人员、技术复审人员
用例建模指南
当用例在捕获系统行为中发挥重要作用时是需要的。应包含建模约定,例如要使用的关系、文本描述所要遵循的风格。

系统分析人员 系统分析人员、需求指定者、设计人员

设计指南
体系结构定义的产品。它描述在设计、体系结构设计和实施期间所要遵循的指南。

软件设计人员 设计人员、实施者、技术复审人员

编程指南
特定于为项目选择的实际实施语言和类库。这些指南应指定如何展示代码布局和注释、如何使用命名约定以及如何使用语言特性。它们还应描述关于某些语言特性的警告信息。

软件设计人员(在主要实施者的帮助下) 实施者、测试人员
用户界面指南
应给出用于构造用户界面的项目特定规则和建议。通常引用外部出版物,如 Microsoft® Corporation 的 The Windows Interface Guidelines for Software Design。

用户界面设计员 用户界面设计员、设计人员、实施者

工具指南
描述项目如何最好地利用所选的工具集合。您可以选择对每个工具提供一个指南。工具指南通常将包括:

  • 安装信息,例如版本、配置参数
  • 功能局限,以及项目决定不使用的功能
  • 变通方法
  • 与其他工具的集成,包括要遵循的过程、要使用的软件以及要应用的准则。
工具专家 工具专家、测试人员、系统管理员、工具用户
测试指南
用于记录对给定项目实施测试流程的方式的调整(通常是战术性的),以及捕获在动态实施测试流程期间发现的特定于项目的做法。测试指南的示例有测试完成标准和缺陷管理指南。

 
测试设计人员 测试设计人员、测试人员、测试分析人员

注意:您不必决定是否使用上述的所有指南。通常,在准备迭代环境的工作过程中才发现需要指南和具体示例。

准备指南以供项目使用
目的: 使所确定的指南可供项目成员使用。

分析生成的一组已确定的指南时,要作出的一个重要决策是“购买还是自建”。尽管您也许能够“免费”获得所需的指南,但您应始终考虑到将这组指南转换为在项目环境中有用的指南的成本,与为特定需要开发指南的成本,或者甚至可能将这些指南一起忽略。

子主题:

获取现有指南 跳至页首

负责项目特定流程的流程工程师不断查找有用的现有指南或示例,它们可以帮助项目成员更高效地生产更高质量软件。公司的资产存储库中可能存在某些指南,这些指南通常是“特定于组织的做法”的汇编。其他指南则归入“公共标准”类别,并可在现有的文献中或通过因特网找到。

开发新的指南 跳至页首

大多数指南最初是作为项目工作产品而生成的,例如项目内某种微流程的文档,并且和大多数其他资产一样,有人会看到指南在项目范围以外的价值,并将其提升为一个可复用的候选指南。

当作出“在项目内生成新指南”这一决策时,则确保它得到恰当的关注并被视为一个内部项目工作产品。这包括分配资源以生成和验证它,并将其包括在相应的迭代计划中。

在第一种情况下,极力建议针对项目的特定环境制定指南。由于注重对工作产品进行泛化推广以供将来复用(而不是针对当前的特定用途开发工作产品),结果导致项目脱轨,这样的事例很多。作为组织流程改进工作的一部分,考虑使生成的指南可供将来的项目重复利用。理想情况下,如果将指南或任何项目工作产品转变为可重用资产,则这一工作会使得超出第一个例子中生成指南的单个项目的预算。

在项目的生命周期内,随时都可以制定新指南。它们一般都以“适时”(just-in-time,JIT)方式开发,或作为一个任务来记录用于生成其他工作产品的成功方法。

定制指南 跳至页首

指南和示例需要适应项目的环境,否则将不使用它们。根据项目来定制指南是流程工程师以及消费者的一些主要代表的职责。努力定制从其他项目中获得的指南尤其重要,因为它们可能是针对稍有不同的环境而制定的。

您应该捕获所做出的任何定制决策,因为它们可能会证明对希望重用同一指南的未来项目有用。

使指南可供访问 跳至页首

和定制指南同样重要的是准备好的指南的可访问性。 消费者应该清楚他们应到何处查找指南或示例,以及要向谁提供使用反馈。

您可使用 RUP 插件技术通过已发布的流程 Web 站点提供指南,在该站点上可将指南与相关的工作产品和任务关联。关于进一步的信息,请参阅概念:定制 RUP。 

维护指南
目的: 基于消费者使用体验改进指南。

在任何注重重用的组织中,对于项目改进工作来说,项目就其对资产的使用提供反馈都是至关重要的。请记住,多数好习惯之所以成为好习惯,是因为它们之前已经使用过多次并有时间进行调整和改进。

当在指南中发现问题或看到潜在的改进时,项目可以选择修订该指南或就此提出变更请求以在项目外部进行处理。作何选择通常取决于组织中流程工作的正式性和问题的复杂性。项目经理应在每个迭代中考虑确定修订和进一步制定指南所需的时间范围。为团队成员提供一个好用的论坛以快速记录已定的潜在改进,这通常是个好想法。

属性
多次出现
事件驱动
正在进行
可选
已计划
可重复
更多信息