tidy up README and add examples