Documenting RESTful APIs with Spring REST Docs - Jenn Strater, Zenjob

December 14, 2017

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 look at features that are new in Spring REST Docs, focusing on support for documenting APIs that have been implemented using Spring Framework 5's WebFlux. Jenn Strater, Senior Engineer, Zenjob Filmed at SpringOne Platform 2017

Previous
Designing, Implementing, and Using Reactive APIs - Ben Hale, Paul Harris
Designing, Implementing, and Using Reactive APIs - Ben Hale, Paul Harris

The Java community is on the cusp of a major change in programming model. As the industry moves towards hig...

Next Video
Implementing Raft in RabbitMQ - Michael Klishin, Karl Nilsson
Implementing Raft in RabbitMQ - Michael Klishin, Karl Nilsson

Team RabbitMQ has been working on adopting Raft, a distributed consensus protocol, in several components of...