some more comments to document the gem
update readme