docs: Add some documentation explaining how shuffle works

docs: Add some documentation explaining how shuffle works #1257