@@ -2124,6 +2124,10 @@ Errors are textual representations of individual validation failures, often
2124
2124
intended for human consumers. This specification contains no requirements for
2125
2125
the content of these errors.
2126
2126
2127
+ Output specifications which include errors SHOULD be written such that the
2128
+ sources (schema and instance) of a given error is easily identifiable and SHOULD
2129
+ use the terms defined by this document to do so.
2130
+
2127
2131
### Annotations
2128
2132
2129
2133
Many keywords are defined to produce annotations, whether intended for
@@ -2132,6 +2136,10 @@ inter-keyword communication (e.g. between `properties` and
2132
2136
` readOnly ` ). Annotation values may be of any type and are defined by the
2133
2137
keywords that produced them.
2134
2138
2139
+ Output specifications which include annotations SHOULD be written such that they
2140
+ can be easily associated with the data defined in {{collect}} and SHOULD use the
2141
+ terms defined by this document to do so.
2142
+
2135
2143
### Dropped Annotations
2136
2144
2137
2145
A dropped annotation is any annotation produced and subsequently dropped by the
@@ -2146,6 +2154,10 @@ as their default behavior. Dropped annotations SHOULD only be included when the
2146
2154
implementation is explicitly configured to do so or if the implementation is
2147
2155
specifically intended to be used as a debugging tool.
2148
2156
2157
+ Output specifications which include dropped annotations SHOULD be written such
2158
+ that they can be easily associated with the data defined in {{collect}} and
2159
+ SHOULD use the terms defined by this document to do so.
2160
+
2149
2161
## Security Considerations {#security}
2150
2162
2151
2163
Both schemas and instances are JSON values. As such, all security considerations
0 commit comments