SpringOne2GX 2015 replay: Documenting RESTful APIs
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…