EVENEMENT

Ordina @ DEVOXX 2015

13 november 2015 - 17:30
- Metropolis Antwerp, Groenendaallaan 394, 2030 Antwerp, Belgium

Ordina Belgium is sponsor of DEVOXX Belgium 2015.

Meet our Java-experts at the Ordina booth during the conference.

Follow the presentation on Monday 9th November, 2015 - 5:25pm to 5:55pm (WET) by Andreas Evers
Spring Restdocs - Documenting RESTful APIs using your tests

Writing documentation for truly RESTful APIs is often done by Swagger or similar tools. However, they provide no support for documenting hypermedia elements, they are URI-centric, leaky and intrusive.
Wouldn't it be nice if your documentation could fail your build in case it gets out-of-date with your production code? Wouldn't you want to write your documentation using a format which is designed for writing? Can't there be a tool which documents your code without using the actual implementation?

Meet Spring Restdocs.
Restdocs allows you to write your documentation as part of your integration tests. In case your documentation doesn't match with your integration test result, your test will fail. This ensures accurate documentation while avoiding the need to put annotations on your production code. It uses the same integration tests to generate snippets, both for request and response bodies, and for hypermedia links. As a writing format it uses asciidoc which is designed for writing.

Follow this session to get a demo on how this tool simplifies your life, and how easy and natural it is to use.

Andreas Evers is Principal Java consultant @Ordina. Passionate about the Spring ecosystem, microservices, REST, clean code, ... Avid open source enthusiast & Spring contributor.

We look forward to meeting you @ DEVOXX!