update readme from official repo
detect a common situation where a typo in the config file can make the code bomb out. instead, we report a meaningful error/suggestion.