docs: README doesn't discuss error-handling in machine APIs

[timbray]

This has just been changed with the recent flatten_json commit and the description of error-handling should be updated, but there is no description.