[SUITEDEV-2114] reorder arguments, extract method
[SUITEDEV-2114] meaningful error message
[SUITEDEV-2114] meaningful error message, range handling
[SUITEDEV-2114] merge validate methods