improved docs for comparison example
added README