readme and comments updates