improved parameters documentation