1700492264
6.9 利用文档的真正力量
1700492265
1700492266
敏捷软件开发的一个信条是避免不必要的文档。也就是说，如果文档没有提供价值，就不要记录。为了文档而写文档是浪费时间。
1700492267
1700492268
这是因为我们通常要花费大量时间准备低层次的、详细的设计文档，而它们很快就会过时。更糟糕的是，这些文档通常没有读者——它们没有用于任何有用的目的，只是表明团队“生成了文档”。因为这非常浪费时间，所以敏捷团队非常认真地审查是否需要生成文档，以确保文档的确有用。
1700492269
1700492270
很多人把这种做法理解成“敏捷开发人员不写文档”，这是错误的。敏捷开发人员的确创建一些文档，但是他们使用务实的过滤方法保证对文档的投资是真正值得的。它必须有价值。
1700492271
1700492272
这让我们想到一个问题：对写作者来说文档的价值是什么？创建低层次的设计文档，简单地反映代码的细节（几乎很快就会过时）对任何人都没有意义。但是其他形式的文档可能是有价值的，即使没有明确的读者。
1700492273
1700492274
路易斯·巴斯德（Louis Pasteur）曾经说过“机会只青睐有准备的人”，核磁共振成像和脑电图测试证实了这一点。一项最近的研究〔17〕表明，将注意力进行内源性的聚焦，这样的心理准备可以促进灵感的闪现，即使这种准备发生时还远没有面对任何具体问题。
1700492275
1700492276
机遇总是青睐有准备的人。
1700492277
1700492278
Chance favors the prepared mind.
1700492279
1700492280
将注意力调整为内源性的，就像你在使用思维导图时那样，在大脑中构建一个有利于灵光闪现的状态。因此，写文档的过程比文档本身更重要。
1700492281
1700492282
飞行员Dierk Koenig也是我的一位读者。他曾给我发来了这样一则故事。
1700492283
1700492284
我在准备飞行例行动作时发现了这个现象。飞行动作的流程在飞行之前都会使用Aresti标记法提前计划和绘制好。在飞行过程中，我们应该记好这个流程，但是驾驶室会贴上有关流程的卡片，以防大脑失灵。
1700492285
1700492286
虽然有Visio插件帮助人们建立非常漂亮的卡片，但是我更喜欢手工制作，采用一种老套的方式。有一次我在机场制作卡片，学校的负责人推了推一名学生，指着我说：“快看，太酷了。”我不知道她为何这样想。我只是觉得自己在花费大量时间制作卡片。
1700492287
1700492288
但是很显然我也在“做思想准备”。
1700492289
1700492290
——Dierk Koenig
1700492291
1700492292
正如我前面所提到的（6.8节），做笔记非常重要，即使你从来不阅读。在Dierk的例子中似乎有很多元素在起作用。
1700492293
1700492294
□ 手动制作增强了R型处理。
1700492295
1700492296
□ 笔记/卡片的主动创建有利于为以后的活动做思想准备。
1700492297
1700492298
□ 可视化流程和预演可以让大脑模拟（我们会在7.6节简要了解更多内容）。
1700492299
1700492300
诀窍31
1700492301
1700492302
写文档的过程比文档本身更重要。
1700492303
1700492304
你不必使用索引卡或者写字的纸，餐巾的背面就不错，或者一个大白板。
1700492305
1700492306
或许你想要花一个小时来制作播客或者视频。你可能发现这对你来说更具效力，对信息的使用者来说更迷人。它也比花一周创建冗长的文档更划算。
1700492307
1700492308
制作视频。
1700492309
1700492310
Make a screencast.
1700492311
1700492312
视频对传递动态信息非常有效：向用户展示如何使用你的软件执行任务，或者通过一套复杂的流程来构建对象的生命周期。这是一种既划算又愉快的方式，它让很多人（甚至远方的人）都想踮起脚尖看看你在讲些什么。
[
上一页 ]
[ :1.700492263e+09 ]
[
下一页 ]