Audit: add JSON Schema for topics and enable it for yml files

[lieser]

JSON Schema can be used to not just validate JSON, but als YAML files. The YAML extension of VS Code supports this.
Use this to to add auto completion and validation of the topic files in local development.

• Adds the YAML extension to the list of recommended extensions.
• Add a JSON Schema for topics.
• Enable the JSON Schema for the YAML files of the topics in the audit report.

[reneme]

That's nice! Didn't occur to me to use JSON Schema for that. 😃
A few days ago, I added some consistency checks to the python generator that is supposed to catch unwanted (aka: misspelled) fields. Is there a way to verify the .yml files against this schema in CI?

[reneme]

Out of curiosity: What's the advantage of requiring the classification here instead of inside the oneOf variant declarations?

[lieser]

The only advantage is not having to write it two times.

Best would be if we could define classification, auditer and comment here completly (not just the required). But that requires the unevaluatedProperties feature, which does not work for the extension redhat-developer/vscode-yaml#704.

[lieser]

Is there a way to verify the .yml files against this schema in CI?

According to https://stackoverflow.com/questions/3262569/validating-a-yaml-document-in-python it should be possible to verify it in Python with PyYAML and jsonschema.

But would leave that as a follow up.