[erlang-questions] Erlang documentation -- a modest proposal

Loïc Hoguin <>
Mon Sep 26 20:39:32 CEST 2016

On 09/26/2016 08:28 PM, Vlad Dumitrescu wrote:
> I saw someone suggesting AsciiDoc. That is a nice language, better than
> Markdown. I don't know how inclined the OTP team is towards replacing
> the XML sources, but I believe that an example of a page would help a lot.
> I will try to convert a module's docs to "better" HTML and AsciiDoc,
> let's see what that gives!

FYI following this thread I started updating the Cowboy documentation to 
be more user friendly with one page per function, examples etc. and the 
first converted module can be found here: 

Could be used as inspiration.

Loïc Hoguin
Author of The Erlanger Playbook,
A book about software development using Erlang

More information about the erlang-questions mailing list