Is it better documentation to have valid json?  (There are several other comments in there for things which are so not easily documented at a distance.)  We also ship a default actual json file.