Skip to content

Commit fb27953

Browse files
handrewsralfhandl
andcommitted
Fix capitalizations
Co-authored-by: Ralf Handl <[email protected]>
1 parent 1bd77b4 commit fb27953

File tree

1 file changed

+5
-5
lines changed

1 file changed

+5
-5
lines changed

versions/3.1.1.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2760,9 +2760,9 @@ This object MAY be extended with [Specification Extensions](#specification-exten
27602760

27612761
##### Extended Validation with Annotations
27622762

2763-
JSON Schema draft 2020-12 supports [collecting annotations](https://datatracker.ietf.org/doc/html/draft-bhutton-json-schema-00#section-7.7.1), including [treating unrecognized keywords as annotations](https://datatracker.ietf.org/doc/html/draft-bhutton-json-schema-00#section-6.5).
2763+
JSON Schema Draft 2020-12 supports [collecting annotations](https://datatracker.ietf.org/doc/html/draft-bhutton-json-schema-00#section-7.7.1), including [treating unrecognized keywords as annotations](https://datatracker.ietf.org/doc/html/draft-bhutton-json-schema-00#section-6.5).
27642764
OAS implementations MAY use such annotations, including [extensions](https://spec.openapis.org/registry/extension/) not recognized as part of a declared JSON Schema vocabulary, as the basis for further validation.
2765-
Note that JSON Schema draft 2020-12 does not require an `x-` prefix for extensions.
2765+
Note that JSON Schema Draft 2020-12 does not require an `x-` prefix for extensions.
27662766

27672767
###### Non-validating constraint keywords
27682768

@@ -2773,7 +2773,7 @@ Extended validation is one way that these constraints MAY be enforced.
27732773

27742774
The `readOnly` and `writeOnly` keywords are annotations, as JSON Schema is not aware of how the data it is validating is being used.
27752775
Validation of these keywords MAY be done by checking the annotation, the read or write direction, and (if relevant) the current value of the field.
2776-
[JSON Schema Validation draft 2020-12 §9.4](https://datatracker.ietf.org/doc/html/draft-bhutton-json-schema-validation-00#section-9.4) defines the expectations of these keywords, including that resource (described as the "owning authority") MAY either ignore a `readOnly` field or treat it as an error.
2776+
[JSON Schema Validation Draft 2020-12 §9.4](https://datatracker.ietf.org/doc/html/draft-bhutton-json-schema-validation-00#section-9.4) defines the expectations of these keywords, including that a resource (described as the "owning authority") MAY either ignore a `readOnly` field or treat it as an error.
27772777

27782778
An example of where ignoring a "written" `readOnly` field might be appropriate is a PUT request where the field is included but the value has not been changed, since the alternative of leaving out the field would result in the field's deletion per [[RFC7231]].
27792779

@@ -2933,10 +2933,10 @@ additionalProperties:
29332933

29342934
```yaml
29352935
oneOf:
2936-
- const: rgb
2936+
- const: RGB
29372937
title: Red, Green, Blue
29382938
description: Specify colors with the red, green, and blue additive color model
2939-
- const: cmyk
2939+
- const: CMYK
29402940
title: Cyan, Magenta, Yellow, Black
29412941
description: Specify colors with the cyan, magenta, yellow, and black subtractive color model
29422942
```

0 commit comments

Comments
 (0)