More documentation for IO

fixes #630 
Can you add a section to the dev docs describing how unit tests should be written? e.g., don't test both filehandles and filepaths, maybe point to some of the existing unit tests for examples