Improve json output and provide instructions on using output

[minight]

Currently the documentation is unclear on how to use the output, (where visual output go to stderr and the actual results go to stdout). Clarity around this would be helpful

Additionally, json output looks scuffed.