docs(tools): hold spring rest docs (#88)

docs(tools): hold spring rest docs
This commit is contained in:
Daniel Kopp
2022-05-06 08:52:47 +02:00
committed by GitHub
parent 02c9f15f28
commit bdf0ed85a1

View File

@@ -0,0 +1,10 @@
---
title: "Spring REST Docs"
ring: hold
quadrant: tools
---
[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.