updated readme and example with comments on how to use it