More documentation for IO

fixes #630 
reader -> writer