The primary goal of this project is to make it easy to document RESTful services by combining content that's been hand-written using Asciidoctor with auto-generated examples produced with the Spring MVC Test framework. The result is intended to be an easy-to-read user guide, akin to GitHub's API documentation for example, rather than the fully automated, dense API documentation produced by tools like Swagger.
For a broader introduction see the Documenting RESTful APIs presentation. Both the slides and a video recording are available.
To learn more about Spring REST Docs, please consult the reference documentation.
You will need Java 17 or later to build Spring REST Docs. It is built using Gradle:
Contributors to this project agree to uphold its code of conduct.
There are several that you can contribute to Spring REST Docs:
spring-restdocs tagSpring REST Docs is open source software released under the Apache 2.0 license.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4