documentation and provider defaults