tweaked the readme
updated doc and added a new example