Improve documentation for required values

[eddie-knight]

Currently the format for required values is somewhat lacking, as it requires a Ctrl+F to find all the required fields. Then some fields may easily be mis-interpreted as required when they are conditionally required for a block (the block isn't required, but if included then certain keys are subsequently required).