@@ -2113,24 +2113,17 @@ applicators such as `$ref` or `$dynamicRef`.
2113
2113
https://example.com/schemas/common#/$defs/allOf/1
2114
2114
```
2115
2115
2116
- When represented in JSON, the key for this information MUST be "schemaLocation".
2117
-
2118
2116
### Instance Location
2119
2117
2120
2118
The instance location is the location of the JSON value within the root instance
2121
2119
being validated. The value MUST be expressed as a JSON Pointer.
2122
2120
2123
- When represented in JSON, the key for this information MUST be
2124
- "instanceLocation".
2125
-
2126
2121
### Errors
2127
2122
2128
2123
Errors are textual representations of individual validation failures, often
2129
2124
intended for human consumers. This specification contains no requirements for
2130
2125
the content of these errors.
2131
2126
2132
- When represented in JSON, the key for this information MUST be "errors".
2133
-
2134
2127
### Annotations
2135
2128
2136
2129
Many keywords are defined to produce annotations, whether intended for
@@ -2139,8 +2132,6 @@ inter-keyword communication (e.g. between `properties` and
2139
2132
` readOnly ` ). Annotation values may be of any type and are defined by the
2140
2133
keywords that produced them.
2141
2134
2142
- When represented in JSON, the key for this information MUST be "annotations".
2143
-
2144
2135
### Dropped Annotations
2145
2136
2146
2137
A dropped annotation is any annotation produced and subsequently dropped by the
@@ -2149,12 +2140,11 @@ This information MAY be included if the validation result of the containing
2149
2140
subschema was unsuccessful. It MUST NOT be included if the local validation
2150
2141
result of the containing subschema was successful.
2151
2142
2152
- Implementations that wish to provide dropped annotations MUST NOT provide them
2153
- as their default behavior. Dropped annotations MUST only be included when the
2154
- implementations is explicitly configured to do so.
2155
-
2156
- When represented in JSON, the key for this information MUST be
2157
- "droppedAnnotations".
2143
+ As the intended purpose for including these annotations is debugging,
2144
+ implementations that wish to provide dropped annotations SHOULD NOT provide them
2145
+ as their default behavior. Dropped annotations SHOULD only be included when the
2146
+ implementation is explicitly configured to do so or if the implementation is
2147
+ specifically intended to be used as a debugging tool.
2158
2148
2159
2149
## Security Considerations {#security}
2160
2150
0 commit comments