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

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.