Spring REST Docs

Spring REST Docs helps you to document RESTful services.

It combines hand-written documentation written with Asciidoctor and auto-generated snippets produced with Spring MVC Test. This approach frees you from the limitations of the documentation produced by tools like Swagger.

It helps you to produce documentation that is accurate, concise, and well-structured. This documentation then allows your users to get the information they need with a minimum of fuss.

Spring Boot Config

Spring Boot provides an @AutoConfigureRestDocs annotation to leverage Spring REST Docs in your tests.

Quick start

Bootstrap your application with Spring Initializr.

Documentation

Each Spring project has its own; it explains in great details how you can use project features and what you can achieve with them.

2.0.4 CURRENT GA	Reference Doc.	API Doc.
2.0.5 SNAPSHOT	Reference Doc.	API Doc.
1.2.7 SNAPSHOT	Reference Doc.	API Doc.
1.2.6 GA	Reference Doc.	API Doc.

A few examples to try out:

Spring HATEOAS Demonstrates the creation of a getting started guide and an API guide for a service implemented using Spring HATEOAS
Spring Data REST Demonstrates the creation of a getting started guide and an API guide for a service implemented using Spring Data REST
Web Test Client Demonstrates the use of Spring REST docs with Spring WebFlux’s WebTestClient
Slate Demonstrates the use of Spring REST Docs with Markdown and Slate
TestNG Demonstrates the use of Spring REST Docs with TestNG
JUnit 5 Demonstrates the use of Spring REST Docs with JUnit 5