[MRG] improved io docs