HarmonyOS开发者限时福利来啦!最高10w+现金激励等你拿~ 了解详情
写点什么

两种类型的敏捷文档——不多不少,刚刚好!

  • 2009-08-16
  • 本文字数:948 字

    阅读完需:约 3 分钟

敏捷宣言提出:“可以工作的软件胜过面面俱到的文档”。这使得很多团队认为敏捷项目中不需要有文档。敏捷评论家们纷纷把有限的文档看作敏捷方法学的弱点。Ron Jeffries 提出,敏捷并非推崇不需要文档或很少的文档,而是强调适当的文档化。他提到,

大家对于 XP 的那个最普遍的质疑其实并不正确。他们认为我们觉得文档化是个坏主意。而 XP 其实致力于将对话的效率最大化。我们关于文档化的建议正是由此而来的。

如出一辙,Eelco Gravendeel 也提出敏捷中就只有两种文档

  • 为了保证项目运行,所有团队成员都觉得有需要的文档 ——在理想情况下,团队在同一个地方一起工作,所有的知识可以通过直接交流得到共享和传播。然而,如果是分布式的团队,知识就不得不通过文档进行传播了,附带一些的影音媒介应该更有效。这时团队至少需要有一套共同的文档规范,来保证大家都说“普通话”,能有相同的理解。

Eelco 建议:需要多留意许多用于产品立项的文档,因为项目一结束它们就没用了;也就是说,

一旦你承认,这些文档仅仅是为了符合产品立项流程而写的,当项目结束或产品发布以后,它们就没用了,那么,理所当然地,对那些主张你把文档做全并保证 100% 正确的声音,你就可以开始说不了!这就是为何写文档是项旷日持久(而且昂贵!)的工作的原因。一旦你认识到这一点,其实只需要写 到刚刚够用,能传话、起到备忘作用就好了,你也会理解形式也不那么重要了:写在纸上、给白板上的图拍个照、茶杯垫后面的草稿、story board 等都行。

  • 最终产品的附带文档 ——这是一些和客户事先定好的、作为产品一部分发布的文档。比较典型的例子包括
  1. 用户手册
  2. 发布手册
  3. 维护手册(用于操作软件)
  4. 技术文档(用于维护代码)等。

对这些文档,Eelco 甚至还建议到:

尽管已经确定哪些文档需要附在产品中,你还是可以在文档的形式上做一些创新。你可以写个冗长的用户手册,抑或用更多 2.0 的技术,像屏幕投影(screen casting),来做文档。后者通常比较便宜(据统计大概便宜 10 倍!),而且可能实际上更加实用。

因此,敏捷中就需要两种文档,一种是对团队有帮助的,另一种是要和最终产品一起发布的。如果一个敏捷团队正在准备一些超出这两类的文档,那就需要多留意一下了。大多时候,团队可以避免做这些文档。

查看英文原文: Two Types of Agile Documents - No More, No Less!

2009-08-16 23:412719
用户头像

发布了 114 篇内容, 共 33.2 次阅读, 收获喜欢 2 次。

关注

评论

发布
暂无评论
发现更多内容

强引用、软引用、弱引用、幻象引用的区别

zarmnosaj

10月月更

外包学生管理系统

早安

架构

为什么最近关注“元数据”的人突然增多?

雨果

元数据 元数据管理 元数据管理平台

Vue组件入门(一)组件定义及使用

Augus

Vue3 10月月更

说说Nodejs高并发的原理

coder2028

node.js

被翻译成 12 种语言的深度学习名著重磅升级,75%新内容,让你豁然开朗!

图灵社区

Python 深度学习

webpack模块化的原理

Geek_02d948

webpack

webpack热更新原理(面试大概率会问)

Geek_02d948

webpack

Red Hat Releases OptaPlanner 8

成长兔🐇

企业如何低成本快速搭建团队知识库,实现企业知识管理?

Baklib

如何制作企业在线产品手册?这里有一些简单的方法!

Baklib

这几款小程序插件可以让效率翻倍

Geek_99967b

小程序

英国国民信托 CIO:如何讲好可持续发展故事

雨果

CIO

一文了解 Python 中的对象比较方法 is 和 ==及其本质

宇宙之一粟

Python 10月月更

我为什么要使用 Tauri 构建 macOS 磁盘清理工具 PrettyClean

NinetyH

tauri ​Rust

Python基础(十四) | Python之禅与时间复杂度分析

timerring

Python 时间复杂度 10月月更 python之禅

【指针】有哪些类型?

Geek_65222d

10月月更

理解NodeJS多进程

coder2028

node.js

展示出你的创意,知识库搭建也可以这样玩!

Baklib

【一Go到底】第十天---位运算and移位运算符

指剑

Go golang 10月月更

小程序容器技术,或许是提升智能设备安全等级的又一解决方案

Speedoooo

浏览器安全 小程序容器

DataOps核心理念是什么?包括哪些模块?

雨果

DataOps

数字化转型最核心的是数据吗?不,是数据思维

雨果

数字化转型 数据思维

企业级低代码开发平台有哪些?

优秀

企业级低代码平台 企业级低代码

实验精神终将胜利:量子纠缠的祛魅七十年

脑极体

爬虫练习题(五)

张立梵

Python. 10月月更 爬虫案例

阳振坤:分布式技术引领关系数据库发展

OceanBase 数据库

深度理解NodeJS事件循环

coder2028

node.js

被翻译成 12 种语言的深度学习名著重磅升级,75%新内容,让你豁然开朗!

图灵教育

Python 深度学习

如何打造优秀的客户体验?

Baklib

客户体验 客户体验管理

星汉未来 | 云原生薪火计划——开源大使招募

星汉未来

开源 开发者 云原生 星汉未来 FinOps

两种类型的敏捷文档——不多不少,刚刚好!_研发效能_Vikas Hazrati_InfoQ精选文章