more clearly document configuration options