readme examples and API