From bdf0ed85a111517ae6ee36dd708a64919f281d80 Mon Sep 17 00:00:00 2001 From: Daniel Kopp Date: Fri, 6 May 2022 08:52:47 +0200 Subject: [PATCH] docs(tools): hold spring rest docs (#88) docs(tools): hold spring rest docs --- radar/2022-03-28/spring-rest-docs.md | 10 ++++++++++ 1 file changed, 10 insertions(+) create mode 100644 radar/2022-03-28/spring-rest-docs.md diff --git a/radar/2022-03-28/spring-rest-docs.md b/radar/2022-03-28/spring-rest-docs.md new file mode 100644 index 0000000..4c70488 --- /dev/null +++ b/radar/2022-03-28/spring-rest-docs.md @@ -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.