Facilitating the Spread of Knowledge and Innovation in Professional Software Development

Write for InfoQ


Choose your language

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