录制于 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 和您的集成测试的强大功能，生成准确且易于阅读的文档，同时保持代码简洁并避免注释过载。我们还将了解 Spring REST Docs 1.1 中的一些新功能，包括对 REST Assured 和 Markdown 的支持。