updated doc comments and readme
updated readme