活文档：与代码共同演进

粗略的看了下，第六章讲了下活文档的基础概念。 活文档类似Swagger，“是一种能与它所描述的系统同步发展的文档。 手动创建活文档非常耗时，因此活文档一般是通过自动化创建的。” 书里面的内容不适合我，都是些理论，没落地，很多地方都是重复的话，说一遍就能懂的。

感觉几千字就能说清楚的东西，楞是拼凑了一本书，也是让人佩服…

活文档的目标是帮助交付更多、更高质量的工作，而不仅仅是制作文档或从中获得乐趣。理想情况下，你在改进活文档上的所有努力最后应该都会在交付、质量或用户满意度方面产生短期可证明的好处。

建议直接看最后一章节，直接把全部总结了

直接看最后一章 活文档模式图表 吧，所有内容都在那个图里

活文档，概念和立意不错，注解驱动文档，dsl ，Tdd,bdd,Ddd概念堆积，都是引用其他人的文章，未给出自己的思考见解，没有实际落地方案。

活文档的理念不错，对软件开发过程中的文档分析的不错，但是具体到落地的例子感觉不深入 当理念看还可以

看开头比较有期待，以为要透彻讲BDD，但后面的内容似乎比较碎，各种文档生成方式。说实话，除了swagger，我觉得其他文档看得人很少。作者比较会讲故事吧，理念蛮多的，倒也有些帮助。但看完后，不理解和DDD有任何关系。

理论偏多，自己的思想偏少。缺乏实际落地方案。