improve docs for configuration