updated readme and comments