updated docs with macs addition of soft_arrays