improve documentation for IO.read

- Readability improvements
- English language fixes
- Formatting fixes