Reminder - Improving project onboarding code

[Danajoyluck]

Need to improve the onboarding code per PR review feedback from @david-a-wheeler . The code needs optimization. This issue serves as a reminder.

[david-a-wheeler]

Great! Just to clarify my JSON comment, since the generated files do not meet the JSON specification, it's confusing & will cause tool problems.

I think the simplest solution is to rename ".json" to ".json5", and where you insert comments, use JSON5's line comment marker "//", like this:

// This is a comment

Sometimes JSON isn't quite enough, and since all you want is JSON with comments, JSON5 should suit you perfectly & require VERY little effort of you. While JSON is used more than JSON5, JSON5 has significant support (e.g., it has built-in support in vim). More about the JSON5 format is here: https://json5.org/