First version of the readme document.

Review by @gzm0 @hubertp
Consider inverting: "Comprehensible and elaborate error messages"