update to the parameters comments