File tree Expand file tree Collapse file tree 1 file changed +10
-5
lines changed Expand file tree Collapse file tree 1 file changed +10
-5
lines changed Original file line number Diff line number Diff line change 2034
2034
<t >
2035
2035
This keyword reserves a location for comments from schema authors
2036
2036
to readers or maintainers of the schema.
2037
-
2037
+ </t >
2038
+ <t >
2038
2039
The value of this keyword MUST be a string. Implementations MUST NOT present this
2039
2040
string to end users. Tools for editing schemas SHOULD support displaying and
2040
2041
editing this keyword. The value of this keyword MAY be used in debug or error
2041
2042
output which is intended for developers making use of schemas.
2042
-
2043
+ </t >
2044
+ <t >
2043
2045
Schema vocabularies SHOULD allow "$comment" within any object containing
2044
2046
vocabulary keywords. Implementations MAY assume "$comment" is allowed
2045
2047
unless the vocabulary specifically forbids it. Vocabularies MUST NOT
2046
2048
specify any effect of "$comment" beyond what is described in this
2047
2049
specification.
2048
-
2050
+ </t >
2051
+ <t >
2049
2052
Tools that translate other media types or programming languages
2050
2053
to and from application/schema+json MAY choose to convert that media type or
2051
2054
programming language's native comments to or from "$comment" values.
2052
2055
The behavior of such translation when both native comments and "$comment"
2053
2056
properties are present is implementation-dependent.
2054
-
2057
+ </t >
2058
+ <t >
2055
2059
Implementations SHOULD treat "$comment" identically to an unknown extension
2056
2060
keyword. They MAY strip "$comment" values at any point during processing.
2057
2061
In particular, this allows for shortening schemas when the size of deployed
2058
2062
schemas is a concern.
2059
-
2063
+ </t >
2064
+ <t >
2060
2065
Implementations MUST NOT take any other action based on the presence, absence,
2061
2066
or contents of "$comment" properties. In particular, the value of "$comment"
2062
2067
MUST NOT be collected as an annotation result.
You can’t perform that action at this time.
0 commit comments