updates to json docs and associated html