slightly improve comments
add instructions for json output