json-schema-spec icon indicating copy to clipboard operation
json-schema-spec copied to clipboard

Statement on annotation values is unclear

Open hudlow opened this issue 1 year ago • 1 comments

The spec says:

Unless otherwise specified, the value of an annotation keyword is the keyword's value.

But neither the phrase "the value of an annotation keyword" nor the phrase "the keyword's value" clearly refer to the value attached to the instance by the collected annotation.

Originally discussed on Slack.

hudlow avatar Mar 05 '24 12:03 hudlow

@hudlow, having re-read the thread, I'm not sure what you need clarified here. Do you have a suggestion for the text?

gregsdennis avatar Jun 18 '24 22:06 gregsdennis

Perhaps:

Unless otherwise specified, the value attached to an instance by an annotation keyword is the value defined for the keyword in the schema.

hudlow avatar Nov 27 '24 19:11 hudlow