Skip to content

Commit 5504ffc

Browse files
committed
added comment for relative pointers in output formatting
1 parent 06cd268 commit 5504ffc

File tree

1 file changed

+12
-8
lines changed

1 file changed

+12
-8
lines changed

jsonschema-core.xml

Lines changed: 12 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -2123,7 +2123,7 @@
21232123

21242124
<section title="Output Formats">
21252125
<t>
2126-
This specification defines four output formats. See the *Output Structure*
2126+
This specification defines four output formats. See the "Output Structure"
21272127
section for the requirements of each format.
21282128
<list>
21292129
<t>
@@ -2177,6 +2177,10 @@
21772177
]]>
21782178
</artwork>
21792179
</figure>
2180+
<t>
2181+
Note that this pointer may not be resolvable due to the inclusion of these
2182+
applicator keywords.
2183+
</t>
21802184
<t>
21812185
The JSON key for this information is "keywordLocation".
21822186
</t>
@@ -2196,8 +2200,8 @@ http://json-schema.org/draft-08/schema#/$defs/nonNegativeInteger/minimum
21962200
</artwork>
21972201
</figure>
21982202
<t>
2199-
This information MAY be omitted if either the relative ___location contains no
2200-
references or if the schema does not declare an absolute URI as its "$id".
2203+
This information MAY be omitted only if either the relative ___location contains
2204+
no references or if the schema does not declare an absolute URI as its "$id".
22012205
</t>
22022206
<t>
22032207
The JSON key for this information is "absoluteKeywordLocation".
@@ -2464,13 +2468,13 @@ http://json-schema.org/draft-08/schema#/$defs/nonNegativeInteger/minimum
24642468

24652469
<section title="Verbose">
24662470
<t>
2467-
The **Verbose** structure is a fully realized hierarchy that exactly matches
2471+
The "Verbose" structure is a fully realized hierarchy that exactly matches
24682472
that of the schema. This structure has applications in form generation and
24692473
validation where the error's ___location is important.
24702474
</t>
24712475
<t>
2472-
The primary difference between this and the **Detailed** structure is that
2473-
*all* results are returned. This includes sub-schema validation results that
2476+
The primary difference between this and the "Detailed" structure is that
2477+
all results are returned. This includes sub-schema validation results that
24742478
would otherwise be removed (e.g. annotations for failed validations,
24752479
successful validations inside a `not` keyword, etc.). Because of this, it
24762480
is RECOMMENDED that each node also carry a `valid` property to indicate the
@@ -2479,7 +2483,7 @@ http://json-schema.org/draft-08/schema#/$defs/nonNegativeInteger/minimum
24792483
<t>
24802484
Because this output structure can be quite large, a smaller example is given
24812485
here for brevity. The full output structure of the example above can be found
2482-
[here](standardized-output-verbose.json)
2486+
<eref target="standardized-output-verbose.json">here</eref>.
24832487
</t>
24842488
<figure>
24852489
<artwork>
@@ -2540,7 +2544,7 @@ http://json-schema.org/draft-08/schema#/$defs/nonNegativeInteger/minimum
25402544
<section title="Output validation schema">
25412545
<t>
25422546
For convenience, a JSON Schema has been provided to validate output generated
2543-
by implementations. It can be found [here](schema-output.json).
2547+
by implementations. It can be found <eref target="schema-output.json">here</eref>.
25442548
</t>
25452549
</section>
25462550

0 commit comments

Comments
 (0)