236. WJUG - Documenting RESTful APIs with Spring REST Docs - Jennifer Strater


Happy to announce that Warszawa JUG together with Warsaw Cloud Native Meeup invites everyone for next regular meeting, which will take place on Tuesday, June 26 at 18.15 at the Faculty of Mathematics of Computer Science and Mechanics, University of Warsaw (Banacha 2), room 3180.


- Documenting RESTful APIs with Spring REST Docs

Documentation generated from source code is very popular. Solutions such as Swagger are available for many different languages and frameworks. However, limitations of annotation-based tools are becoming apparent. An overwhelming number of documentation annotations make for great docs but muddy the source code. Then, something changes and the docs are out of date again. That is where test-driven approaches come in.

Test-driven documentation solutions, such as Spring Rest Docs, generate example snippets for requests and responses from tests ensuring both code coverage and accurate documentation. It can even fail the build when documentation becomes out of date. This session will walk through how to implement test-driven documentation solutions. Examples will be in Spring Boot and Groovy, but the concepts are applicable to other ecosystems too. If time permits, the talk will also include how to document APIs that have been implemented using Spring Framework 5's WebFlux. Attendees should have a basic understanding of a markdown-like documentation tool such as AsciiDoc and how to construct RESTful APIs in a JVM ecosystem technology such as Spring Boot.


Jennifer “Jenn” Strater is a Senior Engineer at Zenjob Gmbh in Berlin, Germany where we revolutionize the way students work. She was formerly a co-founder of GR8Ladies and is now part of the board of GR8DI, the Apache Groovy Diversity Initiative. She has also organized GR8Workshops for developers interested in an overview and crash course in Groovy technologies and presented on several Groovy topics at events such as the Grace Hopper Celebration of Women in Computing, Greach, GR8Conf EU, GR8Conf US, Devoxx Belgium, JFokus, and Spring One Platform.

After the meeting we invite for networking in nearby club-cafe


WJUG started a campaign #call4people, hoping to encourage attendees to submit new presentation. The application form is accessible from our web site, https://warszawajug.typeform.com/to/L5ydtp . And if you need any advisory, assistance or review please reach out to one of the leaders during meetup. They will are very open to assist you.