I know what you've been told. Douglas Crockford said that JSON can't have comments. And you accepted that. Understandable mistake; we've all been there.
But I'm here to tell you there's another way, because Douglas Crockford is not your dad. You can put comments in JSON files if you know they're going to be read only by a reasonable parser. If you maintain a parser, you can make it accept comments, and nothing bad1 will happen!
These ones will just do the right thing with no fuss:
These ones can be configured to accept comments:
These ones have not yet seen the light:
Do you have an addition or correction? Let me know and we can make this site better, together.
But before you contact me about it, yes, I know about json5 and jsonc. Those are fine; not bad necessarily, but just a bit unnecessary, because there are no downsides to making a regular JSON parser accept comments. We don't need a new format, we just need parsers for the existing format that are written by people who understand that Douglas Crockford is not their dad. 2