CB-5648: clarify comments for the parms