added nice error return and some examples in readme