improved readme and examples