improved documentation, fixed examples and rewrote shuffle to not edit the array in-place
removed old random file