Add some more details to the Readme

We now have more information about how we're handling errors so the
Readme can now reflect that.