Spring REST Docs 1.1.0.M1

It’s my pleasure to announce that the first milestone of Spring REST Docs 1.1 has been released. 1.1.0.M1 is available from https://repo.spring.io/milestone/.

What’s New?

REST Assured

As an alternative to the lightweight server-less documentation generation offered by Spring Framework’s MockMvc, you can now use REST Assured to test and document your RESTful services. This opens up Spring REST Docs to all four corners of the JVM and beyond, allowing you to document anything that you can access via HTTP.

Markdown

Support has been added for generating Markdown snippets. On its own, Markdown isn’t as capable as Asciidoctor, but can work very well when combined with existing documentation toolchains such as Slate.

TestNG

In addition to the existing support for using JUnit, you can now use Spring REST Docs with TestNG.

What’s Next?

We’re hoping to publish a release candidate in around two months’ time with a release to follow shortly after that. Please refer to the issue tracker for details of what’s planned and to add any enhancement ideas of your own.

Thank you for the feedback and suggestions that have shaped 1.1.0 thus far. Please try out the first milestone and let us know what you think.