docs(api): explain automatic transport selection