adds note about transport agnostic API consideration to readme