First version of the readme document.

Review by @gzm0 @hubertp
Oh... maybe not in the REPL... but applies for other examples..