在 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 的支持。