updated readme
minor package documentation and example changes