Changes to README.md based on discussion on API