Have something interesting to share with Java Eastern Europe community?
Become a speaker now
Roman Tsypuk

Roman Tsypuk

Senior Engineer at Lohika, Ukraine

Oracle Certified Professional Java 8 developer. Contributes as a speaker on meet-ups and communities, mentors colleagues, has deep experience in telecom area and likes ham radio beyond programming. Roman is the most interested in topics about Spring, JVM performance, security, functional style programming, microservices, Docker.

Speaker's activity
Test Driven Documentation with Spring Rest Docs
May 27th
17:00 - 17:45
Talk
Russian

Documenting RESTful services is important step in development, especially if you are working with microservices architecture or your RESTful APIs are shared and public available. The most widely used tool for this task is Swagger, but it has known limitations and tradeoffs.

Pivotal’s Spring Rest Docs has provided robust, flexible approach that is called Test Driven Documentation. It extends well known Red-Green-Refactoring from TDD with additional phase of building documentation on the fly. This approach aligns 3 main components in your project – code base, integration tests and documentation and you are absolutely sure that your documentation is always up to date because it is generated from your tests. Furthermore it supports HATEOAS and provides lots of new features that are not available in Swagger.

During this talk Roman will give a detailed overview of Spring Rest Docs as well as demonstrate practical usages of it within a Spring Boot app. Also, Roman will advise how to migrate your existing swagger’s project documentation into asciidoc format, extend it with tests and start using Spring Rest Docs.

Slides