new README, better error messages