InfoQ Homepage Presentations Writing Comprehensive and Guaranteed Up-to-Date REST API Documentation

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



Andreas Evers introduces Spring REST Docs and its test-driven approach to RESTful API documentation. He looks at how it combines the power of Asciidoctor and integration tests to produce documentation that's accurate and easy-to-read, while keeping code DRY and free from annotation overload.


Andreas Evers is a principal Java consultant at Ordina. He is passionate about the Spring ecosystem, microservices, REST, clean code and best practices in general. He is an avid open source enthusiast and Spring contributor. He helps fellow developers as Competence Center leader for architecture and best practices by giving workshops, talks and courses about the newest technologies.

About the conference

SpringOne Platform brings together the people, process and tools for delivering and operating software services. Learn and share with the startups and enterprises leveraging modern Java with Spring connecting all the pieces of the modern software puzzle from developer, operator, architect, data scientist to executive.

Recorded at:

Jan 21, 2017

Hello stranger!

You need to Register an InfoQ account or or login to post comments. But there's so much more behind being registered.

Get the most out of the InfoQ experience.

Allowed html: a,b,br,blockquote,i,li,pre,u,ul,p

Community comments

Allowed html: a,b,br,blockquote,i,li,pre,u,ul,p

Allowed html: a,b,br,blockquote,i,li,pre,u,ul,p


Is your profile up-to-date? Please take a moment to review and update.

Note: If updating/changing your email, a validation request will be sent

Company name:
Company role:
Company size:
You will be sent an email to validate the new email address. This pop-up will close itself in a few moments.