Files
TechradarDev/radar/2022-03-28/spring-rest-docs.md
Daniel Pötzinger bcf1ead9b3 documentation: Add tags to all featured blibs (#139)
* documentation: add tags to all featured blips
2022-11-18 11:39:23 +01:00

12 lines
700 B
Markdown

---
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.