In response to a linkpost to an article about how YAML isn’t perfect, user jiveturkey commented with confusion:

JSON doesn’t support comments

eh?

{ "firstName": "John", "lastName": "Smith", "comment": "foo", }

I know it isn’t the same as #comments, but who cares really.

I replied:

The trouble there is that your comments come in-band. What if you’re trying to serialise something and you don’t have the power to insist that it’s not a dictionary with “comment” as a key?