update README and config comments