Improve comments around adding 'type' to JSON objects