documented comparing of arrays