adding some fixes to the comments