README.md: round out the API description