
上QQ阅读APP看书,第一时间看更新
本书内容
第1章“重新思考文档”从根本上重新审视文档,为本书其余内容奠定基础。
第2章“BDD:活需求说明的示例”描述了BDD如何成为活文档背后的关键灵感,尽管BDD本身并不是本书的核心主题。
第3章“知识开发”和第4章“知识增强”为其他实践构建奠定了基础,具体讨论了提取已有的知识,以及用缺少的内容来增加知识。
第5章“活知识管理:识别权威性知识”强调知识是不断变化的,展示了如何通过管理将这样的知识为我们所用。
第6章“自动化文档”详述了如何将知识同步转化为文档和图表,使其能反映知识的每个变化。
第7章“运行时文档”是前一章的延伸,讨论了如何使用仅在运行时才能访问的知识。
第8章“可重构文档”以代码为中心,重点描述如何使用开发工具来使文档保持最新状态。
第9章“稳定文档”探讨了这样一种观点,即对于不变的知识,你不需要使用活文档技术,并讨论了如何更好地记录这类知识。
第10章“避免传统文档”介绍了一种更加叛逆的观点,重点描述文档的替代方法。
之前的章节都在介绍如何通过设计改进文档,第11章“超越文档:活设计”则介绍如何通过关注文档帮助你改进设计本身。
第12章“活架构文档”将活文档理念应用于软件架构,并讨论了一些特殊技术。
第13章“在新环境中引入活文档”指导如何在你的环境中引入活文档。这基本上是一种社会性挑战。
因为遗留系统不可避免,所以第14章“为遗留应用程序编写文档”介绍了一系列特定的模式,用于处理这些“难啃的”遗留系统。
“补充知识:显而易见的文档”介绍了一些实用的建议,可以使你的文档更加引人注目,从而让你所有的活文档计划更为有效(内容见图灵社区本书页面)。
“活文档模式图表”将活文档的模式做成了图表,便于你深刻认识模式之间的一些关系(内容见图灵社区本书页面)。