add tests to ensure the different output formats produce the same results
simplify the readme and move the details to docs and simplify.
