address review comments for configuration doc