README: Update the readme with examples and API docs