More documentation for IO

fixes #630 
you defined OO above, but are using OOP here. can you use one acronym for consistency?