if this is a public method, it might be worthwhile mentioning the parameters in the docstring...