First version of the readme document.

Review by @gzm0 @hubertp
Does not flow otherwise.