SpringOne2GX 2015 replay: Documenting RESTful APIs

News | Pieter Humphrey | January 12, 2016 | ...

Recorded at SpringOne2GX 2015. Track: Web / Javascript Track Speaker: Andy Wilkinson Slides: http://www.slideshare.net/SpringCentral/documenting-restful-apis An API's documentation is a vital part of making it easy to understand and easy to use. RESTful APIs are no different. In this talk we'll look at what should be included in your RESTful API's documentation and, just as importantly, what should be omitted. Using real-word examples, both good and bad, we'll discuss how the documentation should be structured so that it's informative, succinct, and easy to read. Having identified what good documentation looks like, we'll discuss some of the tools that are available for documenting services built using Spring. In particular, we'll look at some of the problems and limitations of choosing a tool like Swagger and how some alternatives, including Spring REST Docs, avoid these shortcomings and help you to produce documentation that your users will love.

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

Tanzu 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