Skip to content

Commit ddbd53f

Browse files
authored
Merge pull request #3726 from handrews/format-vocab
Be more clear about `format` support (3.1.1)
2 parents 6d1ca8e + c48dd1a commit ddbd53f

File tree

1 file changed

+2
-1
lines changed

1 file changed

+2
-1
lines changed

versions/3.1.1.md

+2-1
Original file line numberDiff line numberDiff line change
@@ -156,7 +156,8 @@ Data types in the OAS are based on the types supported by the [JSON Schema Speci
156156
Note that `integer` as a type is also supported and is defined as a JSON number without a fraction or exponent part.
157157
Models are defined using the [Schema Object](#schemaObject), which is a superset of JSON Schema Specification Draft 2020-12.
158158

159-
<a name="dataTypeFormat"></a>As defined by the [JSON Schema Validation vocabulary](https://tools.ietf.org/html/draft-bhutton-json-schema-validation-00#section-7.3), data types can have an optional modifier property: `format`.
159+
<a name="dataTypeFormat"></a>As defined by the [JSON Schema Validation specification](https://tools.ietf.org/html/draft-bhutton-json-schema-validation-00#section-7.3), data types can have an optional modifier property: `format`. As described in that specification, `format` is treated as a non-validating annotation by default; the ability to validate `format` varies across implementations.
160+
160161
OAS defines additional formats to provide fine detail for primitive data types.
161162

162163
The formats defined by the OAS are:

0 commit comments

Comments
 (0)