added docs and changed return value to include zipped version of x and y data