Test Driven Documentation with Spring Rest Docs (Roman Tsypuk, Senior Engineer at Lohika) скачать в хорошем качестве

Test Driven Documentation with Spring Rest Docs (Roman Tsypuk, Senior Engineer at Lohika)

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.