I can't speak for others. When I write something that uses JSON for configuration files those files are pretty much always written from configuration management

I can't speak for others. When I write something that uses JSON for configuration files those files are pretty much always written from configuration management. The comments are then in the manifest/recipe/playbook that generates the config file, which is where people are actually working with the values.