add: README.md - updated doc with API and usage