chore(json): improve code and add notes to fix

related to #CAM-2458