JSON schema for Hugo

[EmilyGraceSeville7cf]

I've created a JSON schema for HUGO to add several hints in config.json/config.yml files. It covers most properties (but some of them have no descriptions due to documentation problems). I think it's better to place schema in this repo because HUGO maintainers better know HUGO and how it must work.

Please consider this PR the for the source code. I need help with the following things:

• properties without descriptions: write descriptions for them
• grammar in descriptions (please suggest better descriptions at your glance)

The descriptions have to be very short but descriptive.

[jmooring]

@EmilySeville7cfg

It looks like you have put a lot of effort into this, and conceptually it is a nice idea, but I'm not convinced that the value it provides is worth the effort to create and maintain.

1. Most sites that I have seen use TOML for configuration and YAML for front matter. If I had to guess, I would say YAML and JSON site configurations collectively represent 5-10% of all projects, at most.
2. The minimal site configuration for a single language, single output-format site is 3 lines, excluding menu entries and custom parameters. This is possible due to sane defaults, and we spend an agonizing amount of time making sure they are mostly right.
3. Or to look at it a different way, the best site configuration is the one that has the fewest entries possible to achieve the desired functionality. With that in mind, making it easy to add configuration values without a contextual understanding of the ramifications may cause more problems than it solves. I have seen this repeatedly in my efforts to support site authors.
4. Generally speaking, with the exception of menu entries and custom parameters, there really isn't much need to edit the site configuration over the project's lifetime. It's something you mostly do at the beginning of a project, with minor adjustments over time to add or modify functionality.

Again, I think it is a nice idea, but I have no interest in authoring, maintaining, or supporting it. If we were to prioritize this against all of the documented issues (bugs and enhancements), I think this effort would be in the bottom 5%.

I know that isn't what you want to hear, particularly after the apparent efforts you have made thus far.

[EmilyGraceSeville7cf]

I can maintain it myself via PRs. 😄 All bugs/enhancements for this schema can be assigned to me.