update comments on file after code review