progress on examples and API