improved parameter documentation