update readme and comments