add new array functions examples
add documentation