Spring REST Docs 1.0.0.M1

Releases | Andy Wilkinson | June 25, 2015 | ...

I'm delighted to announce that Spring REST Docs has reached its first milestone and that 1.0.0.M1 is available from https://repo.spring.io/milestone.

Spring REST Docs helps you to document RESTful services. It combines hand-written documentation written with Asciidoctor and auto-generated snippets produced with Spring MVC Test. This approach frees you from the limitations imposed by tools like Swagger. It helps you to produce documentation that is accurate, concise, and well-structured. This documentation then allows your users to get the information they need with a minimum of fuss.

Getting started

To get started with Spring REST Docs, please refer to the getting started section of the reference documentation.

If you'd like to learn more about the thinking behind Spring REST Docs and how it can help you, this presentation on YouTube may also be of interest.

SpringOne 2015

I'll be talking about documenting RESTful APIs at this year's SpringOne in Washington, DC. I'd love to see you there.


  • The Early Bird price tier (June 13th - August 14th) is discounted $150.
  • Register 4 and get the 5th pass free. Contact us with the names of your first 4 registrants for your complimentary pass code (conference admission only).
  • Alumni, contact us for your discount code ($150 off any option).

Get the Spring newsletter

Thank you!

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