Skip to content

Commit e121405

Browse files
author
Phil Sturgeon
committed
another go at arbitrary keywords
1 parent f8f92ed commit e121405

File tree

1 file changed

+1
-3
lines changed

1 file changed

+1
-3
lines changed

versions/3.1.0.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2321,7 +2321,7 @@ The following properties are taken from the JSON Schema definition but their def
23212321

23222322
Alternatively, any time a Schema Object can be used, a [Reference Object](#referenceObject) can be used in its place. This allows referencing definitions instead of defining them inline.
23232323

2324-
In addition to the JSON Schema properties, the following OpenAPI vocabulary properties MAY be used for further schema documentation:
2324+
In addition to the JSON Schema properties defined in the JSON Schema Core and JSON Schema Validation vocabularies, any properties can be used from any vocabularies, or entirely arbitrary keywords. OpenAPI has its own vocabulary properties which MAY be used for further schema description:
23252325

23262326
##### Fixed Fields
23272327

@@ -2335,8 +2335,6 @@ Field Name | Type | Description
23352335

23362336
This object MAY be extended with [Specification Extensions](#specificationExtensions).
23372337

2338-
In previous versions of OpenAPI, Specification Extensions were the only way to add properties, but since v3.1.0 matches JSON Schema in allowing any properties to be used inside the Schema Object. These properties could be defined in their own vocabulary, or entirely arbitrary, and they do not need to follow any specific naming pattern or convention.
2339-
23402338
###### <a name="schemaComposition"></a>Composition and Inheritance (Polymorphism)
23412339

23422340
The OpenAPI Specification allows combining and extending model definitions using the `allOf` property of JSON Schema, in effect offering model composition.

0 commit comments

Comments
 (0)