use the updated example in the readme
document inline errors in the readme