added more documentation of parameters