More documentation for IO

fixes #630 
Might be clearer / more general to phrase as:

Writers will always mutate an already opened filehandle (e.g., change the filehandle's position). This allows for a file to be written to more than once without overwriting the contents of a previous write.