updates to json docs