improved readme and error handling