adding more parameter documentation