some suggested comment changes