improved readme and improved examples