Skip to content

Commit 824fd47

Browse files
committed
Fix $comment paragraphs
No idea when this happened.
1 parent 553489d commit 824fd47

File tree

1 file changed

+10
-5
lines changed

1 file changed

+10
-5
lines changed

jsonschema-core.xml

Lines changed: 10 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2034,29 +2034,34 @@
20342034
<t>
20352035
This keyword reserves a location for comments from schema authors
20362036
to readers or maintainers of the schema.
2037-
2037+
</t>
2038+
<t>
20382039
The value of this keyword MUST be a string. Implementations MUST NOT present this
20392040
string to end users. Tools for editing schemas SHOULD support displaying and
20402041
editing this keyword. The value of this keyword MAY be used in debug or error
20412042
output which is intended for developers making use of schemas.
2042-
2043+
</t>
2044+
<t>
20432045
Schema vocabularies SHOULD allow "$comment" within any object containing
20442046
vocabulary keywords. Implementations MAY assume "$comment" is allowed
20452047
unless the vocabulary specifically forbids it. Vocabularies MUST NOT
20462048
specify any effect of "$comment" beyond what is described in this
20472049
specification.
2048-
2050+
</t>
2051+
<t>
20492052
Tools that translate other media types or programming languages
20502053
to and from application/schema+json MAY choose to convert that media type or
20512054
programming language's native comments to or from "$comment" values.
20522055
The behavior of such translation when both native comments and "$comment"
20532056
properties are present is implementation-dependent.
2054-
2057+
</t>
2058+
<t>
20552059
Implementations SHOULD treat "$comment" identically to an unknown extension
20562060
keyword. They MAY strip "$comment" values at any point during processing.
20572061
In particular, this allows for shortening schemas when the size of deployed
20582062
schemas is a concern.
2059-
2063+
</t>
2064+
<t>
20602065
Implementations MUST NOT take any other action based on the presence, absence,
20612066
or contents of "$comment" properties. In particular, the value of "$comment"
20622067
MUST NOT be collected as an annotation result.

0 commit comments

Comments
 (0)