2013年9月10日星期二08:42

敏捷文档到底有什么用?

由Ellen Gottesdiener和Mary Gorman撰写

最近,我们与一个敏捷团队合作,该团队正在构建FDA监管的医疗设备。一些团队成员担心如何产生所需的验证和确认文件。 “我们做什么?”他们问我们。 “我们不应该在敏捷文档中做文档。”

这是一个神话。在敏捷中,问题不在于是否要记录。它是创建哪种文档以及何时创建。像敏捷中的所有其他内容一样,这些决定是基于您对价值的评估(在这种情况下,是文档的价值)。更多文档不一定更好。实际上,产品文档的数量通常与其价值成反比。

gottesimg01 Aug28图1:文档数量和价值之间潜在的非线性关系
图片来源:发现交付:敏捷产品规划和分析,Gottesdiener和Gorman,2012年

流程与产品文档

您基本上有两种类型的文档:过程文档和产品文档。无论哪种情况,我们都敦促团队关注文档的使用者,并仔细查看其使用需求。从消费者的角度看文档,并探索其可用性需求,以确定最小的有用和可用的文档。

流程文档描述了涉众在发现和交付产品(软件应用程序,系统或包含软件的设备)时产生的在制品或移交信息。对于位于同一地点且精通领域的团队而言,过程文档的价值要小于在不同时区和具有不同程度的领域专业知识的分布式模式下工作的团队的价值。另一方面,就如我们客户的情况一样,即使是位于同一地点的团队,如果要制造受管制的产品并需要产品验证的证据,也可能需要过程文档。 

产品文档传达了有关产品的信息,是一种很有价值的资产,因为它用于销售,服务和使用产品。考虑产品文档的使用者可能是监管机构的验证分析师,产品最终用户,安装人员,技术支持人员,现场人员,维护程序员等。 

对于我们的医疗设备客户,产品文档中包含一个演示脚本,用于进行经过验证的学习以测试产品创意本身的演示。我们从现场进行演示的人员的角度出发,因此,我们以简洁的表格格式制作了小册子,其中包含简短的功能描述和演示步骤。这本手册不仅“足够”足以记录产品,而且生产速度也很快。作为奖励,交付团队发现该格式对于入职新团队成员很有用。 

各就各位…

包括产品所有者在内的团队需要决定何时生成文档。有两种元模式:在构建软件时(以及您最了解创建文档的知识时)以一点一点的增量来构建它,或者推迟到发行之前(将文档打包为更大的集合,一次全部创建) )。

当需求众所周知时,尽早进行文档记录是很有意义的。另一方面,我们的医疗设备客户实质上是一家初创企业。潜在的救生设备已在医院的患者中进行实验性使用,并且随着产品本身的测试要求不断变化。这意味着记录团队在每次迭代中交付的内容会很浪费。他们同意在产品的整个实验使用过程中,在每次发行之前等待记录文档(这大致相当于精简型初创企业所说的“验证学习”)。对于这个团队来说,推迟文档是很有意义的。

优良作法是将文档作为完成产品切片的验收标准的一部分,无论是故事,功能还是最低限度的销售功能-无论您使用哪种锚来描述要交付的需求。当您将必要和充分的文档作为验收标准的一部分时,您只需付出很少的努力即可获得价值。

沿文档杆滑动

考虑文档的形式,准确性和需求的波动性。您是否需要符合预定义格式,签名等的文档?非正式文件足够好吗?文档必须有多精确?谁在使用文档,目的何在?与我们的医疗团队一样,由于需求的多变性,过早地进行文档记录将是浪费的,但是,在生产时,它必须准确而正式。

没有一种适合所有人。如图2所示,不同的产品和项目情况会影响您如何调整文档计划。

gottesimg02 Aug28图2:使文档适应不同的产品
图片来源:发现交付:敏捷产品规划和分析,Gottesdiener和Gorman,2012年

资料不足

文档归结为知识转移。在可能的情况下,分批编写文档,并交付足以满足文档特定用户需求的文档。通过这种方式,您可以最大程度地创造自己的价值,从而为您的投资做出贡献。

不要忘记在下面留下您的评论。

参考:
Gottesdiener,Ellen和Mary Gorman。 发现交付:敏捷产品计划和分析。 EBG咨询公司,2012年。

关于作者:

例如 艾伦·格特斯迪纳(Ellen Gottesdiener), Founder 和 Principal of EBG咨询,是需求+产品管理+项目管理协同融合的领导者。艾伦(Ellen)指导个人和团队,并促进发现和计划研讨会。她是一位认证的专业主持人和一位Scrum认证专家,她撰写广泛的主题演讲,并在世界各地演讲。除了共同创作 发现交付:敏捷产品计划和分析,艾伦(Ellen)是《 协作需求 and 软件需求记忆推纸器.

mbg玛丽·高曼是业务分析和需求的领导者,是质量副总裁& Delivery at EBG咨询。玛丽指导产品团队并促进发现研讨会的开展,并且她培训利益相关者进行协作实践。她演讲并撰写有关敏捷,业务分析和项目管理的文章。 Mary是一位获得认证的Business Analysis Professional™和Scrum认证大师,帮助开发了IIBA®Business Analysis知识体系和认证考试,以及PMI®业务分析角色描述。玛丽是《 发现交付:敏捷产品计划和分析.

©BA Times.com 2020

麦格雷戈徽标白色网站