Writing Comprehensive and Guaranteed Up-to-date REST API Documentation

August 11, 2016
SpringOne Platform 2016 Speaker: Andreas Evers; Principal Consultant, Ordina RESTful APIs are eating the world, yet all too often the documentation can cause indigestion for the APIs' developers and their users. Developers have to deal with annotation overload, repetition, and an unpleasant writing environment. Users are then left with documentation that's inaccurate and difficult to use. It doesn't have to be this way. This talk will introduce Spring REST Docs and its test-driven approach to RESTful API documentation. We'll look at how it combines the power of Asciidoctor and your integration tests to produce documentation that's accurate and easy-to-read, while keeping your code DRY and free from annotation overload. We'll also look at some of the features that are new in Spring REST Docs 1.1, including support for REST Assured and Markdown.
Previous
Reactor 3.0, a JVM Foundation for Java 8 and Reactive Streams
Reactor 3.0, a JVM Foundation for Java 8 and Reactive Streams

SpringOne Platform 2016 Speaker: Stéphane Maldini; Project Reactor Lead, Pivotal. The apparent simplicity...

Next Presentation
A Lite Rx API for the JVM
A Lite Rx API for the JVM

SpringOne Platform 2016 Speakers: Sebastien Deleuze; Spring Framework Committer, Pivotal. Stephane Maldini;...