活文檔：與代碼共同演進

粗略的看了下，第六章講了下活文檔的基礎概念。 活文檔類似Swagger，“是一種能與它所描述的系統同步發展的文檔。 手動創建活文檔非常耗時，因此活文檔一般是通過自動化創建的。” 書裏面的內容不適合我，都是些理論，沒落地，很多地方都是重複的話，說一遍就能懂的。

感覺幾千字就能說清楚的東西，楞是拼湊了一本書，也是讓人佩服…

活文檔的目標是幫助交付更多、更高質量的工作，而不僅僅是製作文檔或從中獲得樂趣。理想情況下，你在改進活文檔上的所有努力最後應該都會在交付、質量或用戶滿意度方面產生短期可證明的好處。

建議直接看最後一章節，直接把全部總結了

直接看最後一章 活文檔模式圖表 吧，所有內容都在那個圖裏

活文檔，概念和立意不錯，註解驅動文檔，dsl ，Tdd,bdd,Ddd概念堆積，都是引用其他人的文章，未給出自己的思考見解，沒有實際落地方案。

活文檔的理念不錯，對軟件開發過程中的文檔分析的不錯，但是具體到落地的例子感覺不深入 當理念看還可以

看開頭比較有期待，以爲要透徹講BDD，但後面的內容似乎比較碎，各種文檔生成方式。說實話，除了swagger，我覺得其他文檔看得人很少。作者比較會講故事吧，理念蠻多的，倒也有些幫助。但看完後，不理解和DDD有任何關係。

理論偏多，自己的思想偏少。缺乏實際落地方案。