designing the error flow

and some updates to the readme