code comments review and ammendment