annotated code
update readme