Document JSON format upgrade issues