More improvements

- added convenience functions for reading/writing
- documentation improvements
- added runnable example