Skip to content

Commit 720d572

Browse files
handrewshudlow
andauthored
More accurate wording
Co-authored-by: Dan Hudlow <[email protected]>
1 parent b517699 commit 720d572

File tree

1 file changed

+1
-1
lines changed

1 file changed

+1
-1
lines changed

src/oas.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2171,7 +2171,7 @@ For `externalDataValue`, it is always the parsed data that is significant, not i
21712171
While JSON Schema allows for applying schemas to data outside of its data model, this allowance is intended to support consistent use of Schema Objects, including fields such as `readOnly` that do not impact JSON Schema's validation outcome.
21722172
No standard format suitable for passing such non-JSON data to JSON Schema has been defined, and therefore data that is outside of the JSON data model cannot be represented with `dataValue` or `externalDataValue`, and MUST use `serializedValue` or `externalSerializedValue`.
21732173

2174-
Note that `serializedValue`, which MUST be a string, is by necessity a sequence of Unicode code points, which may need to be re-encoded based on the character set or other constraints of the target ___location.
2174+
Note that `serializedValue`, which MUST be a string, is by necessity a sequence of Unicode code points, which will need to be encoded based on the character set or other constraints of the target ___location.
21752175
This conversion is purely one of encoding. All escaping necessary to reduce the example to the set of characters valid for the target ___location (e.g. URI percent-encoding) MUST be included in the `serializedValue`.
21762176
If the target ___location's encoding is ambiguous, `externalSerializedValue` can be used to demonstrate the exact serialization, including character set encoding, that is intended.
21772177

0 commit comments

Comments
 (0)