update the docs on the decorator
update the README