slightly improve IO docs, see #2911
Merge pull request #1413 from akka/wip-2.1-IO-docs-∂π

2.1: slightly improve IO docs, see #2911