知识卡片
过度文档化与"完全不写规格说明"之间的中间道路
围绕文档和规格说明书的争论常常滑向两个极端,而两个极端都是对同一个问题的过度反应。一个极端是像Rational统一过程(RUP)那样,把画大量图表、编写厚厚的规格说明书作为过程的核心——这类文档表面上是为了让非专家团队的人也能理解项目,但实际上常常异化成团队用来和组织内其他人隔离开的一堵墙,本该承担的责任心和透明度反而被这堵”文档墙”遮蔽掉了。另一个极端是对前者的逆反:”既然写了很多僵化的规格说明书没有用,那干脆什么都不写”,把敏捷简单理解为”什么文档也不写,直接开始编码”——这同样是一种过度反应,用完全放弃规划来对抗过度规划的弊病。真正健康的位置在两者之间:文档和规格说明本身不是问题,问题在于文档是否服务于团队之间的透明沟通,还是被异化成一堵掩盖问题、逃避责任的墙。判断标准不是”写不写文档”,而是”这份文档是不是真正促进了信息在团队和组织之间的流通”。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- 第20章 在Google的开发工作(Alex Martelli访谈录) · 查看原书依据
我认为很多团队都喜欢生成厚厚的一摞文档,因为他们都在使用这些文档构筑一道与组织内其他人隔开的墙,而这些地方可能需要责任心和透明度。
参考来源
- 位置:《团队之美》第20章《在Google的开发工作》(Alex Martelli访谈录,源文件:_epub-src/OEBPS/Text/part0037.xhtml)
- 结论依据:原文批评RUP式的厚重文档常被团队用来构筑与组织其他人隔开的墙,也批评把敏捷简单理解为"什么文档也不写、直接开始编码"的过激反应,并明确提出"在两者之间存在一个可行的中间方式",直接支撑本卡片结论。
- 原始内容:我认为很多团队都喜欢生成厚厚的一摞文档,因为他们都在使用这些文档构筑一道与组织内其他人隔开的墙,而这些地方可能需要责任心和透明度。……在两者之间存在一个可行的中间方式,你知道吧?