First version of the readme document.

Review by @gzm0 @hubertp
Maybe you meant "errors that do not leak internal details"?