updates to the comments in the code