Petar Tahchiev | Devoxx

Petar Tahchiev
Petar Tahchiev Twitter

From Nemesis Software`


agTest DevOps, Agile, Methodology & Culture

JUnit, Spring RESTDocs, Asciidoctor and Maven when you need to document your APIs


This presentation will focus on the challenges we faced when we tried to document our product - the Nemesis Ecommerce Platform. It will show you the different approaches we tried and why we actually decided to go for Asciidoctor and SpringRESTDocs. This presentation is not only a deep-dive into SpringRESTDocs functionalities, but it will also show you how we automated the whole process of documentation by extending SpringRESTDocs to produce our documentation widgets, specifically the rest-tester widget, how we let Maven pre-process all of that, and how we configured Asciidoctor to produce what is now our current documentation.