👋Hey there,I'm Dimitri

I like trying out new frameworks and writing about them. Below you can find the latest articles I wrote.


Generating documentation for your REST API with Spring and Swagger

September 25th, 2018 | 9 min read | AsciiDoc, Maven, Spring boot, Swagger

A while ago, I used Springfox to include Swagger into our Spring projects. This allows us to use the Swagger UI tester to obtain some live documentation and testing for our REST APIs. However, sometimes you also want to have a static version of the documentation available, so that it can be printed, read without […]

Exploring contract first options with Swagger

September 27th, 2016 | 9 min read | REST, Spring, Spring boot, Swagger

In my latest tutorial I documented a simple REST API with Swagger and Springfox. While this approach certainly showed how valuable documenting your REST API can be, we aren’t really “done” yet. In the great world of SOA we know something like “contract first development”, in which we initially describe the web service (using WSDL) […]

Documenting your REST API with Swagger and Springfox

September 20th, 2016 | 17 min read | REST, Spring, Spring boot, Swagger

In my last tutorial I built a REST service together with a REST client. Like I said before, REST services are pretty great to allow reuse of your operations, however, to become reusable, you’ll have to properly document the available endpoints in your REST API, which endpoints there are, what they can do, what they […]