Improve docs for shuffle instrumentation