added documentation for index parameters