more debugging, readme, and better error handling