Why do we keep having the "comments in JSON" discussion? Just use YAML.

json-with-comments-in.yaml

{
  # this is a comment
  "a": "hello", 
  # this is another comment
  "b": -1, 
  "c": [
    true,
    "test",
    null
  ], 
  # yet another comment
  "d": {
    "x": 1,
    "y": 2 
  }
}

plain-old.yaml

# this is a comment
a: hello
# this is another comment
b: -1
c:
 - true
 - "test"
 - null
# yet another comment
d:
 x: 1
 y: 2

See how a YAML parser parses:

• json-with-comments-in.yaml
• plain-old.yaml

If you want to use a YAML configuration file on the server/command line, there are YAML libraries for most languages. For example, Grunt's grunt.file.readYAML method uses the npm js-yaml module.

If you need to use data stored in YAML in the browser, you can compile all your YAML files into JSON before sending them to the client, as part of your build process with a Grunt plugin like grunt-yaml (I haven't tested it, personally).

May have to copy this idea!

:)