录制于 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 的支持。