Edit of I/O docs. Fixes #3047

Some, hopefully uncontroversial, editing. I have a few other questions which I'll post on akka-dev.