updated the readme and comments