added parameter docs