accept arrays
doc updates