First version of the readme document.

Review by @gzm0 @hubertp
I think that this is our perspective. The users want to know about comprehensible errors.
Maybe actionable?
Anyhow I rephrase so it flows a bit better. Also, removed a few typos.