update comments in preparation for release