First version of the readme document.

Review by @gzm0 @hubertp
Done, see if you like it.