The aim of this Spring REST Docs extension is to help you write even less - both code and documentation. You still get the same nice documentation as with Spring REST Docs itself. The main benefit is that writing less and moving the documentation closer to the code increases the maintainability of the documentation.
In Spring REST Docs you have to add the documentation for your JSON with a DSL in your test. We moved this documentation to the POJO that represents your JSON object. You just add Javadoc to the fields and it will end up in the documentation.
Learn more in the Introducing Spring Auto REST Docs article.
- Automatic documentation of request and response fields.
- Automatic documentation of path and query parameters.
- Automatic documentation of field and parameter constraints
- A helper to document authentication.
- A snippet that includes all other snippets.
- Shorten JSON arrays in example requests and responses.
- Replace binary example requests and responses with
<binary>.
See the Getting started section in the documentation.
See the Building from source section in the documentation.
Spring Auto REST Docs is Open Source software released under the Apache 2.0 license.