Back to program
- 17:30
Cinema 6
Intermediate -

Test Driven Documentation for your RESTful service

Building RESTful APIs in Java? Getting tired of the annotation bloat forced upon you by your API specification framework which haunts your RESTful service controllers and model objects? Finding yourself in the situation where your code isn’t always in synch with your specification or vice versa?
RAML and Swagger / OpenAPI are great specifications with powerful and shiny tooling, but they do also really have their downsides when it comes to messing with our code.

Fear not! There are other alternatives worth investigating. In this talk, we’ll take a look at how we recently build, designed and documented a public REST API by doing Test Driven Documentation with some help of AsciiDoc and Spring (Auto) REST Docs.

About the speakers


Jeroen Reijn

Software Architect at Luminis /Amsterdam

Jeroen is a software architect at Luminis and is very passionate about software engineering and engineering culture. He likes to share his broad knowledge and helps the organizations he works with to apply practices like Continuous Delivery to reach a new level of productivity.
He has a strong Java background and is committer and active community member on several open source projects at the Apache Software Foundation.