updates to API docs in README.md