update documentation location and adjust readme
update readme with new examples