Improve docs for shuffle instrumentation
Merge pull request #209 from pwendell/better-docs

Improve docs for shuffle instrumentation