Spring REST Docs 1.2.0.RC1

Releases | Andy Wilkinson | March 24, 2017 | ...

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/.

What's new?

A complete overview of what's new in 1.2 can be found in the release notes. The following are some of the highlights.

Improved Asciidoctor integration

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.

Better support for documenting large and complex payloads

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 for request and response bodies

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.

What's next?

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.

Get the Spring newsletter

Thank you for your interest. Someone will get back to you shortly.

Get ahead

VMware offers training and certification to turbo-charge your progress.

Learn more

Get support

Spring Runtime offers support and binaries for OpenJDK™, Spring, and Apache Tomcat® in one simple subscription.

Learn more

Upcoming events

Check out all the upcoming events in the Spring community.

View all