minor updates to API; added info about deployment to README.md