Skip to content

Commit 7433906

Browse files
handrewshudlow
andauthored
Clarified wording
Co-authored-by: Dan Hudlow <dan@hudlow.org>
1 parent c0d0e51 commit 7433906

1 file changed

Lines changed: 1 addition & 1 deletion

File tree

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)