DOC: io.rst cleanups

@jreback, I read through this today and did some tweaks as
I went along. Could you look this over and merge if these changes
look ok to you?