Edit of I/O docs. Fixes #3047
Merge pull request #1135 from akka/wip-3047-edit-io-docs-rich

Edit of I/O docs. Fixes #3047