More documentation for IO

fixes #630 
Can you mention that the items yielded by the generator will depend on the specific file format that is being read?