More documentation for IO

fixes #630 
~~we~~