examples and improved readme