all parameters should be documented. And a sentence or two what the method does would be also helpful!