docs(readme): first draft of API