Documentation is missing

[macisamuele]

The documentation of the library is missing and not published.
The goal of this issue is to ensure that once the library is stabilised (at least a bit) we do publish some docs.
A library with no docs is not really usable developers other than the implementer of the library ;)