Hacker News Reader

I often hear the “comments aren’t supported” argument against JSON, but as a daily consumer, creator, and maintainer of JSON, I honestly can’t recall ever _really_ needing comments in JSON. It tends to be somewhat self documenting in my experience.

View on HN

A config file without comments can mean serious annoyance.

If JSON was developed more recently on places like GitHub, it would never have ended up like that with that many deficiencies.

When maintaining a JSON file, did you ever happen to wonder why a particular value is what it is?

This is where comments belong.

If it's that important and complex, have an accompanying README that lists line numbers and comments.

Lesson to learn: Nobody reads the docs.

This is such a dumb aphorism. I read and create docs every single day.

If the comments are so critical that it is a problem, then an accompanying file with those comments would be used. Otherwise, it's just a bunch of crocodile tears.

Good idea! And then put a comment into the configuration file that refers to where the documentation is.. ah, f__k!

Reply on news.ycombinator.com