Another json fix

and some docs to replace the comment