update the readme with new example code
update docs