readme and better exception handling