document default and custom adapters