added docs for the parameters