website/docs: document new provider lookup logic