---
title:      "Spring REST Docs"
ring:       hold
quadrant:   tools
tags: [documentation]
---

[Spring REST Docs](https://spring.io/projects/spring-restdocs/) auto generates [Asciidoctor](http://asciidoctor.org/) snippets with the help of [Spring MVC Test](http://docs.spring.io/spring/docs/current/spring-framework-reference/htmlsingle#spring-mvc-test-framework) or [RestAssured](https://www.aoe.com/techradar/tools/rest-assured.html).
So you can be sure that your tests are inline with the documentation.

We now use an Api First approach in conjunction with [Open API](https://www.aoe.com/techradar/tools/open-api.html). We see an active community there and a lot of support with this approach.