前言

我从未想过要写一本关于活文档的书，甚至没想过这个话题值得写一本书。

很久以前，我就有一个宏伟的梦想，希望能开发一些工具，它们能理解我们在编码时做出的设计决策。几年来，我花了大量闲暇时间试图构思一个框架来实现这个梦想，却发现打造一个适合所有人的框架非常困难。尽管如此，每当发现这种想法有助于我正在实施的项目时，我就会尝试。

2013年，我在Øredev开发者大会上就重构需求说明发表了演讲。演讲结束时，我提到了一些一直在尝试的构思，结果人们对活文档概念给出了热烈反馈，这令我非常惊讶。那时，我才意识到人们可能需要更好的方法来编写文档。从那以后，我又在其他一些场合做了类似的演讲，收到的反馈源源不断：关于文档、如何改进文档，以及如何无须人工介入即可实现实时和自动化文档。

活文档这个术语由Gojko Adzic在《实例化需求：团队如何交付正确的软件》1一书中引入。该书将它作为实例化需求说明的优势之一。对于一个不局限于需求说明的概念来说，活文档是个好名称。

1该书已由人民邮电出版社出版，详见图灵社区。——编者注

关于活文档，我有很多想法想与大家分享。我将所有已经试过的想法列了一个清单，并写下了我从中学到的与这个主题相关的其他内容。更多的想法则来自其他人，包括我现实生活中认识的人以及我通过Twitter认识的人。想法越来越多，所以，我决定将它们编辑成书。我相信，与其提供一个现成的框架，不如用一本书来帮你快速创建和自定义解决方案来编写你自己的活文档。