updates readme and adds examples