More documentation for IO

fixes #630 
object -> objects