More documentation for IO

fixes #630