项目敏捷文档的好处

人们有时相信“这是敏捷的，所以没有文档”或“敏捷是反文档的”。这两种说法都不正确。相反，敏捷软件开发的增量和迭代性质为创建、利用和改进文档提供了机会，从而为项目和涉众带来新的价值。

敏捷软件开发的宣言说:“我们已经开始重视工作软件而不是全面的文档。”

这种说法有时被解释为敏捷是反文档的。然而，在四个值之后的句子提供了不常被讨论的清晰度:“也就是说，虽然右边的项目有价值，但我们更重视左边的项目。”

换句话说，文档有价值，而工作软件更有价值。这是一个关于优先事项和重点的声明。它并不是建议人们只关注工作软件而忽略文档。

为了进一步扩展这一思想，宣言的12项原则之一是:“简单，即最大化未完成工作的艺术，是至关重要的。”开发人员努力使项目尽可能简单，以避免由于不必要的复杂性而造成的浪费。应该生成足够的文档，以有效和高效地执行项目，而不会越界导致浪费。

这可以通过收益递减定律来解释。需要评估文档的增量效益，并用于衡量所需的适当数量。在评估之后，如果有更多的文档对项目有好处，那么就应该提供。然而，如果增量文档不能为项目提供增量价值，那么应该将其视为浪费并予以消除。没有两个项目是完全相同的，所以文档的数量会有所不同。

文档可以通过提供清晰度、获得反馈和简化复杂的想法而使项目受益。所有这些好处都可以简化并帮助团队更快地实现其目标——工作软件。

敏捷文档的区别

敏捷文档是存在的，但是敏捷思维和方法不同于传统项目。scrum是敏捷框架下的各种框架之一，其中有产品和冲刺积压、发布和回顾等概念。这些概念中的每一个都用于特定的目的和情况。backlog组织和优先考虑即将到来的和当前的工作，发布为即将到来的工作计划提供可见性，回顾检查团队表现并定期确定改进的领域。

敏捷项目不会使用“一刀切”的方法来编制文档。文档的类型因项目的不同而不同，这取决于交付一个成功产品所需要的内容。一个很好的类比是，一个勤杂工为即将到来的工作将工具装入工具箱。他们只会装载工作所需的工具，而不是将所有的工具都装入工具箱。如果勤杂工把他们所有的工具都装进工具箱，他们就增加了杂物，可能会导致隐藏那些具有更高效益和项目价值的工具。

scrum中的一些文档示例包括;

• 产品backlog——描述正在构建的产品的特性和需求
• Sprint backlog——产品待办事项列表的一个子集，在sprint期间获得最高优先级
• 〇发行计划随着时间的推移，提供对特性计划交付的可见性
• 回顾笔记-团队用于持续改进的见解和活动
• 〇燃烧图表通过显示已完成的工作和计划的工作，为团队进度提供可见性
• 任务板-提供当前sprint期间进度的可见性。

其他适合该情况的文档示例。其中许多也用于更传统的项目中。

• 用例—描述系统中参与者/角色所采取的操作
• 角色- - - - - -代表以某种方式使用系统的用户类型的虚构角色
• 环境模型——描述系统运行的上下文;用户、环境、参与者
• 数据模型-定义系统中数据如何与其他数据交互，描述业务规则
• 状态图-记录复杂的业务规则，并从一种状态更改到另一种状态
• 以人为本的设计方法购买一个功能，你的雷达上有什么，亲缘关系图。

结论

对于传统项目和敏捷项目来说，拥有适当数量的文档对于一致性、决策制定、计划和共享信息都很重要。文档类型的选择将取决于所使用的项目方法的类型以及项目和项目涉众的独特需求。

-这最初出现在Matrix Technologies的网站．矩阵技术是CFE媒体和技术内容合作伙伴。由网页内容经理克里斯·瓦夫拉编辑，控制工程， CFE媒体与技术，cvavra@cfemedia.com。

您是否具有本内容中提到的主题的经验和专业知识?你应该考虑为我们的CFE媒体编辑团队做出贡献，并获得你和你的公司应得的认可。点击在这里开始这个过程。