allow predefined configurations
added doc for config to provider