Updated README to reflect changes in API

Also added a paragraph about performance implications