refactor I/O documentation