updated the readme to make examples & explanation clearer