Skip to content

Commit ef309c2

Browse files
handrewshudlow
andcommitted
Clarified wording
Co-authored-by: Dan Hudlow <[email protected]>
1 parent 4093055 commit ef309c2

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
@@ -1676,7 +1676,7 @@ Unlike `schema`, which is applied to the complete content (treated as an array a
16761676

16771677
Both `schema` and `itemSchema` MAY be used in the same Media Type Object, although doing so is unlikely to have significant advantages over using the `items` keyword within the `schema` field.
16781678
OpenAPI Description authors are responsible for avoiding the use of the `schema` in any situation where tooling may not be able to discern when the content is complete.
1679-
For example, if partial content is read from a stream and then passed with the `schema` value to a schema evaluator that is unaware of the stream context, the results are well-defined but will not be meaningful in terms of validating a keyword like `maxItems` as there may be additional items in the stream that are unknown to the schema evaluator.
1679+
For example, if partial content is read from a stream and then passed with the `schema` value to a schema evaluator that is unaware of the stream context, the results will not be meaningful as there may be additional items in the stream that are necessary to or prohibitive of successful validation.
16801680

16811681
##### Special Considerations for `text/event-stream` Content
16821682

0 commit comments

Comments
 (0)