Kommentare für Kategorien-Liste (enum)

[sopheck]

Im Json-Schema können keine herkömmlichen Kommentare mit // oder /* verwendet werden (nicht valides Schema).

Evtl. kann der Json-Schema-Key "comment" verwendet werden. Ist zu recherchieren.

[sopheck]

Kommentare direkt in enum wurde auch von der Community bei JSON-Schema angefragt und abgelehnt, da es sich um einen breaking change handelt.

Siehe Issues:

• https://github.com/json-schema-org/json-schema-spec/issues/57#issuecomment-247861695
• https://github.com/json-schema-org/json-schema-vocabularies/issues/47

Es wird von JSON-Schema folgender Workaround vorgeschlagen:

{
  "docHint": "enum",
  "anyOf": [
    { "const": "a", "description": "A" },
    { "const": "b", "description": "B" },
    { "const": "c", "description": "C" }
  ]
}