活文档:与代码共同演进
上QQ阅读APP看书,第一时间看更新

本书主题

《实例化需求:团队如何交付正确的软件》一书介绍了活文档的概念,其中用于文档编写的一个行为示例促成了自动化测试。只要测试失败,就表示文档与代码不同步,你就能快速修复它。这个想法表明我们可以编写出有用的文档,它们不再是“发布即过时”的。但是,我们还能做得更多。

本书拓展了Gojko的活文档概念,包含一种能与项目的业务目标、业务领域知识、架构和设计、流程和部署等方面的代码同步发展的文档。

本书结合了一些理论和实践,并配有插图和具体示例。你将学习如何开始编写始终保持最新的文档。此外,由于精心设计的工件和合理的自动化程度,这种文档需要额外投入的成本极低。

你将发现你可以兼顾软件开发和文档维护。