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

RESTful API 正在吞噬世界，然而，API 的文件常常給 API 開發者及其使用者帶來消化不良。開發者必須處理註解過載、重複以及不愉快的編寫環境。使用者則只能使用不準確且難以使用的文件。情況不一定非得如此。

本次演講將介紹 Spring REST Docs 及其測試驅動的 RESTful API 文件方法。我們將探討它如何結合 Asciidoctor 和您的整合測試的強大功能，生成準確易讀的文件，同時保持您的程式碼 DRY（不重複）且沒有註解過載。我們還將介紹 Spring REST Docs 1.1 中的一些新功能，包括對 REST Assured 和 Markdown 的支援。