update comments to reflect accurate state