More doc comments

- Adds error conversion for Reader & Writer trait implementation.
- Adds various doc comments. 
We'll need this `FromError` to be able to work with `try!`.