more documentation, more concise param