On behalf of everyone who contributed, it’s my pleasure to announce that Spring REST Docs 1.2.0.RC1 has been released and is available from https://repo.spring.io/milestone/.
A complete overview of what’s new in 1.2 can be found in the release notes. The following are some of the highlights.
REST Docs now has a new module,
spring-restdocs-asciidoctor, that makes it easier to use the generated snippets in your documentation. A new macro means that you can import multiple snippets for the same operation in a single line. This update to the samples shows the benefit of adopting the macro.
To help to make your documentation easier to consume, the documentation of large and complex payloads can now be split up. Subsections of the payloads can be documented individually allowing your documentation to guide your users through the pieces that matter.
Snippets that document the body of a request or response are now included in the default snippets. You can also use these snippets explicitly to document a subsection of a large or complex body.
We’re hoping to publish a release in a few weeks’ time. Please take the release candidate for a spin and let us know if you find any problems or if you have a suggestion for some last-minute improvements.