Julien Richard-Foy, Daniel Krzywicki - (...) Documentation Of Your JSON Protocols(Lambda Days 2016)

365 views · Published 6 May 2016 · 48:20 · Indexed 20 September 2026

Channel: Erlang Solutions · 2016 · Science & Technology

Watch on YouTube

Slides and more info: http://www.lambdadays.org/lambdadays2016/julien-richardfoy
"Deriving The Documentation Of Your JSON Protocols" 

You write a Web service. You need to document the structure of the JSON blobs used by your API. You realize that this documentation must be consistent with your JSON protocols and that you don’t want to maintain both separately. Instead, you’d like to derive the documentation from the implementation of the protocols. How to achieve that?

I will present some technical approaches to solve this problem, digress about type classes, algebraic data types and the expression problem, and eventually end up with a simple yet powerful solution to get documentation consistent with the implementation.

More from this channel