extend readme

put comparison output to stderr and easily machine readable stuff to stdout

fix bug in example

dont panic, rather return errors in main

add a lot of docs and a reference to them in the README

implement compare_vector util

implement decode vector

translate encode_vector

restructure and add documentation

Initial commit