more comments and adjustment to updateScores