“AI 技术+人才”如何成为企业增长新引擎?戳此了解>>> 了解详情
写点什么

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

  • 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:412626
用户头像

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

关注

评论

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

机构进场区块链安全基础设施准备好了么?

CECBC

区块链 数字资产

关于招聘的一些思考

石云升

面试 考核 招聘 下放招聘权

SQL 如何做 Join

Rayjun

sql

框架设计:作业

Nick~毓

来不及解释了,快上车!快速开发平台,助力企业搭乘万物互联顺风车

Philips

敏捷开发 企业开发 互联网革命

AI小白必读:深度学习、迁移学习、强化学习别再傻傻分不清

华为云开发者联盟

人工智能 学习 迁移

四年开发经验从美团、360、陌陌、百度、阿里、京东面试回来感想

Java架构师迁哥

Rust所有者被修改了会发生什么?

袁承兴

rust 内存管理 智能指针

跟着B站UP主小姐姐去华为坂田基地采访扫地僧

华为云开发者联盟

华为 技术 大牛 扫地僧

SpringBoot-技术专题-提升服务吞吐量

洛神灬殇

架构师训练营---第二周课后练习

Jacky.Chen

【FastDFS】小伙伴们说在CentOS 8服务器上搭建FastDFS环境总报错?

冰河

分布式存储 fastdfs

JAVA JDBC

Isuodut

命题作业

黄立

设计模式

因材施教,阿里腾讯大牛耗时7天,整理不同人群适合的面试题合集

小Q

Java 编程 程序员 架构 面试

一周信创舆情观察(9.14~9.20)

统小信uos

进击的无源光网络:产业园区里的“追光者”

脑极体

【架构笔记之架构方法】架构师训练营第1期第1周

业哥

极客大学架构师训练营

某大厂一位核心技术人员不小心泄漏的公司内部培训以及工作笔记内容,手慢无。

Java架构师迁哥

从『用户』到『客户』,企业服务平台如何实现高效转化?

易观大数据

一文快速入门分库分表

程序员小富

Java 分库分表

架构师训练营第 1 期第二周总结

Leo乐

极客大学架构师训练营

为什么海外服务器打开网站会卡呢?

德胜网络-阳

架构师训练营 1 期第 2 周:框架设计 - 总结

piercebn

极客大学架构师训练营

Week 2 Assignment

Yinan

行到瀚海阑干处,坐看华为云起时:中国互联网航海家的远大征程

脑极体

架构师训练营 1 期 - 第二周 - 设计原则

三板斧

极客大学架构师训练营

Git 操作

老菜鸟

git

云小课 | 不小心删除了数据库,除了跑路还能咋办?

华为云开发者联盟

数据库 数据恢复 dba

一个草根的日常杂碎(9月25日)

刘新吾

社会百态 生活随想 日常杂碎

游戏夜读 | 数据治理的悖论

game1night

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