issue 17 - add example for format conversion and more documentation on types and formats