在 SpringOne Platform 2016 錄製。演講者：Andreas Evers, Ordina JWorks 幻燈片：http://www.slideshare.net/SpringCentral/writing-comprehensive-and-guaranteed-uptodate-rest-api-documentation

RESTful API 正在席捲世界，但 API 文件常常會讓開發者和使用者感到消化不良。開發者不得不處理大量的註解、重複和令人不愉快的編寫環境。使用者最終得到的是不準確且難以使用的文件。情況不必如此。

本次演講將介紹 Spring REST Docs 及其 RESTful API 文件的測試驅動方法。我們將瞭解它如何結合 Asciidoctor 的強大功能和您的整合測試來生成準確且易於閱讀的文件，同時保持程式碼的 DRY 原則並避免過多的註解。我們還將瞭解 Spring REST Docs 1.1 中的一些新功能，包括對 REST Assured 和 Markdown 的支援。