added documentation about parameters