演講者：Andy Wilkinson

API 的文件是使其易於理解和使用至關重要的一部分。RESTful API 也不例外。在本次網路研討會中，我們將探討 RESTful API 文件應包含的內容，以及同樣重要的，應省略的內容。為了說明這一點，我們將透過一些真實世界的優秀和糟糕 API 文件示例進行分析。我們將探討使用 Swagger 等工具生成 API 文件時存在的一些問題和侷限性，並最終討論一些更適合生成使用者喜愛的文件的替代方案。

瞭解更多關於 Spring MVC 的資訊 http://projects.spring.io/spring-framework

瞭解更多關於 Spring REST Docs 的資訊 https://github.com/wilkinsona/spring-restdocs