錄製於 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 的支援。