作者都是各自领域经过审查的专家,并撰写他们有经验的主题. 我们所有的内容都经过同行评审,并由同一领域的Toptal专家验证.
维诺德·苏库马兰的头像

Vinod Sukumaran

Vinod是一位经验丰富的技术项目经理,专注于开发web, 移动, 为全球客户提供数字产品.

专业知识

以前在

position2
分享

各种文件, 工件, 与他们产生的过程有关的是一些主要的象征 瀑布 模型. 借鉴精益, 敏捷认为大量的文档是“浪费”,为了简化开发生命周期,需要消除它们.

对于很多项目经理来说, it’s not a big str等h to underst和 how the 瀑布 phases are turned into sprints—the same work is accomplished; it’s just organized in a different way. 然而, 删除大多数文件是一颗难以下咽的药丸,因为它强调了一种完全不同的工作方式. 这需要放松控制, 拥抱未知, 并授权交付团队在现场做出决策.

传统的文档方法正在受到挑战

在瀑布方法中,大量时间花在文档上 项目需求 详细的解决方案. 当需求完全清晰时,这个过程就会起作用,并且我们确信没有任何东西会改变所捕获和基线的内容. 然而,过去几十年大多数公司的经验表明,这几乎从来都不是真的. 在当今世界, 变更的速度是如此的动态,以至于当我们完成文档阶段时,客户的需求会发生很大的变化.

敏捷的重点是完成任务并为涉众增加价值. 它是以这样一种方式构建的,即该模型不鼓励在外围设备和不能直接和立即为客户端增加价值的活动上工作.

敏捷项目管理文档vs. 瀑布

每个公司都有不同级别的文档,甚至在项目级别上也会有所不同. 但是,敏捷的文档处理方法与使用的过程有很大的不同 瀑布 项目. 以下是每个文档实践的比较视图:

瀑布敏捷
文档在大多数情况下是强制性的. 除非文档完成,否则工作无法进行.我们鼓励只提供基本的文档来理解,以便开始工作.
文件要经过漫长的审查过程,必须得到多方的批准.没有正式的审查和批准过程,项目经理是关键的决策者.
需要遵循标准化模板.的re are no formal templates for 文档; best practices are used instead.
不同阶段需要不同类型的文件:项目章程, 愿景声明, 业务需求文档, 功能性和非功能性需求, 高级设计(HLD)和低级设计(LLD)文档, 等.只需要在即将到来的sprint中交付功能所需的文档.
更改文档很困难,因为所有文档都是交织在一起的.更改文档要容易得多.
需要一个系统或流程来管理大量的文档.文档很少,因此易于管理.

文档化的案例

瀑布提倡更严格的文档方法,这似乎有些过分. 但在我们认为这是“浪费”之前,以下是拥有强大的文档程序的几个好处.

策略性思考的机会

不做计划的人,只会计划失败. 文档要求项目经理坐下来仔细思考,然后提出最佳解决方案. 在敏捷中,人们有时会误解文档,认为不需要文档. 这是基于将工作软件优先于全面文档的敏捷价值. 然后他们就冲到市场上,这是苹果公司产品副总裁保罗·亚当斯(Paul Adams)的举动 对讲机, 描述为 往墙上扔东西,看能粘住什么. 设计解决方案, 创建计划, 深思熟虑的行动——这些活动通过节省时间来创造价值,而不是开发每一个想到的功能想法.

用户体验和功能一致性

随着公司从几个创始人发展到数百或数千名员工, 许多不同的团队开始研究相同或相关的产品. 团队A可能会认为他们正在做的事情与团队B正在做的事情无关, 但是对于最终用户来说, 都是同一种产品. 而不是跨职能团队各司其职, 关于用户体验和功能层面的清晰文档避免了脱节的用户流.

文档可以转换为用户指南

在《欧博体育app下载》中,我们花了大量时间去详细阐述解决方案以及如何使用它们. 高保真图像 设计 是为前端开发人员创建的吗. 与从头开始创建相比,所有这些资产转换为内部或外部用户指南所需的工作更少.

敏捷如何减少文档需求

经常出现的一个借口是员工流动. 管理者担心,当员工离开,新员工加入接替他们时,他们会失去对企业的了解. 他们如何知道已经实现了什么以及它是如何工作的? 他们需要多长时间才能赶上? 当前的团队是否有足够的带宽容纳新的团队成员?

我们希望良好的文档能够让那些独立工作的新员工快速上手. 然而, 通过协作技术,对敏捷项目文档的需求本质上减少了, 同时, 减少入职时间. 以下是敏捷减少文档需求的几种方法.

产品团队和敏捷团队成员之间的定期互动

敏捷宣言 促进“个体和交互,而不是过程和工具”.因为需求在项目过程中会发生变化,并且会产生新的想法, 敏捷确保直接从源头澄清需求,而不是依赖于需要不断更新的编写工件.

仪容整洁和计划划分任务

待办事项整理和冲刺计划将功能分解为具体的, 易于理解且可以独立工作的可实现部分. 这为新员工创造了一个机会,让他们在早期就能富有成效, 虽然还没有完全了解整个项目的大局.

用户故事提供有效的文档

敏捷文档的用户故事模板.

的简单格式 用户故事 允许项目经理捕获在所有团队成员之间创建共享理解的最小需求. 即使 用户故事 不把它变成冲刺,创建这个文档工件的浪费是非常低的. 随着用户故事进入冲刺阶段, 他们可以充实和补充其他所需的信息,如线框图, 设计, 验收标准, 等. 这个过程提供了一个非常有效的文档交付,它是高度一次性的,并且在最合适的开发阶段生成.

减少对代码文档的需求

诸如结对编程和代码审查之类的技术为在整个团队中传播技术知识创造了不断的机会, 尤其是对新的团队成员. 不断的反馈导致了共同的理解,这种理解也具有适应新环境的灵活性,而不是在某个文档中迅速过时.

敏捷的仪式

每日站立会议, sprint审查, 回顾会议为面对面解决问题和做决定创造了充足的机会,而不是依赖于电子邮件和文档. 所有仪式的有限时间框架确保只有最重要的信息被优先考虑,而不是花时间记录每件事, 即使它可能永远不会被使用.

以上所有这些都直接或间接地减少了文档,并对项目目标的交付进行了优先级排序,同时确保没有因为缺乏文档而真正失去任何东西.

文档的混合方法

即使是在敏捷环境中,一些公司仍然喜欢有一些文档. 敏捷不是规定性的, 因为每个项目都是不同的,并且有一组需要解决的独特环境.

下面是一些例子,说明了敏捷如何与更耗时的文档方法相结合.

结合UML和敏捷

UML图示例

考虑使用标准的建模语言,例如统一建模语言(UML),它是非常结构化的,并且具有定义的实体来可视化系统. 这有助于保持内容非常简单,专注于需要的内容,并确保最少使用书面语言. 工具包括 StarUML画.io等等,都是方便的选择.

代码文档生成器

另一种方法是通过在类细节中引入更结构化和更详细的注释来确保代码的可读性, 方法详细信息, 参数的使用, 依赖关系, 等等......。. 有许多工具可以自动化从源代码生成有用文档的过程,它们被称为 文档生成器. 它们的范围从通用的到特定于编程语言的.

详细的设计和用户体验文档

使用线框图、模型、用户流程图、序列图等定义需求. 有助于简化项目流程,并使技术团队清楚地知道需要开发什么. 设计文档 拥有不同级别的更严格的文档是一种好方法吗. 有各种各样的 线框图UX 为这些任务选择的工具.

项目管理工具自动化文档

更强大的 项目管理及相关工具JIRA, 融合, 体式, Basecamp 提供一种将所有项目相关信息保存在一个地方的方法. 任务可以链接, 标记, 嵌套的, 并分配给不同的团队成员, 谁可以留下评论并报告任何问题. 所有这些动作, 此外,还具有适应这些工具的灵活性, 可以毫不费力地创建大量文档吗.

此外,从历史上看,部分文档需求源于报告需求. 涉众希望访问团队绩效或其他相关指标. 项目管理工具使自动化自定义仪表板和视图变得容易,这些仪表板和视图反映了项目进度,并链接回工具中的相关文档.

文档管理是一种平衡行为

敏捷宣言的创建者写道,他们更重视“可工作的软件而不是全面的文档”.“然而, 他们还添加了一个免责声明,“虽然右边的物品有价值, (他们)更看重左边的东西.“敏捷并不建议删除 所有 文档, because some 文档 obviously provides value; it simply suggests that the priority should be on working software 和 adding 文档 only as necessary depending on the circumstances of the project 和 without heavily impeding development progress.

项目经理必须在花更少的时间在文档上和花更多的时间在交付工作软件上之间取得平衡,并找出某种形式的文档对于长期成功是必要的.

了解基本知识

  • 敏捷有文档吗??

    敏捷项目管理文档是最少的, 只包括维护项目稳定性所必需的内容. 然而,敏捷提倡协作而不是文档,这是共享知识的首选方式.

  • 敏捷是否意味着没有文档?

    如果团队能够通过其他方式有效地共享知识,敏捷有时意味着不需要文档. 这通常只在小团队中才有可能,当公司发展到几十或几百人时,不可避免地会引入一些文档.

  • 敏捷方法中产生的文档是什么?

    没有预定义的文档必须根据敏捷来生成. 团队必须自己决定需要多少文档,并且不会阻碍开发进度.

  • 文档的主要目的是什么?

    文档的主要目的是保留制度知识,并在团队成员和任何其他相关涉众之间创建共享的理解.

  • 什么是文档过程?

    文档过程是一组预定义的操作,用于解释如何以及在项目的各个阶段创建哪些类型的文档.

就这一主题咨询作者或专家.
预约电话
维诺德·苏库马兰的头像
Vinod Sukumaran

位于 印度卡纳塔克邦的班加罗尔

成员自 2019年6月7日

作者简介

Vinod是一位经验丰富的技术项目经理,专注于开发web, 移动, 为全球客户提供数字产品.

Toptal作者都是各自领域经过审查的专家,并撰写他们有经验的主题. 我们所有的内容都经过同行评审,并由同一领域的Toptal专家验证.

专业知识

以前在

position2

世界级的文章,每周发一次.

订阅意味着同意我们的 隐私政策

世界级的文章,每周发一次.

订阅意味着同意我们的 隐私政策

欧博体育app下载

加入总冠军® 社区.