various minor corrections.
MODIFY
versions/3.0.md
versions/3.0.md
@@ -181,7 +181,7 @@ It combines what previously was the Resource Listing and API Declaration (versio
Field Name | Type | Description
---|:---:|---
-<a name="oasVersion"></a>openapi | [OpenAPI Version String](#oasVersion) | **Required.** Specifies the OpenAPI Specification version being used. It can be used by tooling Specifications and clients to interpret the version. The structure SHALL be `major`.`minor`.`patch`, where `patch` versions MUST be compatible with the existing `major`.`minor` tooling. Typically patch versions will be introduced to address errors in the documentation, and tooling SHOULD typically be compatible with the corresponding `major`.`minor` (3.0.*). Patch versions will correspond to patches of this document.
+<a name="oasVersion"></a>openapi | `string` | **Required.** Specifies the OpenAPI Specification version being used. It can be used by tooling Specifications and clients to interpret the version. The structure SHALL be `major`.`minor`.`patch`, where `patch` versions MUST be compatible with the existing `major`.`minor` tooling. Typically patch versions will be introduced to address errors in the documentation, and tooling SHOULD typically be compatible with the corresponding `major`.`minor` (3.0.*). Patch versions will correspond to patches of this document.
<a name="oasInfo"></a>info | [Info Object](#infoObject) | **Required.** Provides metadata about the API. The metadata can be used by the clients if needed.
<a name="oasServers"></a>servers | [[Server Object](#serverObject)] | An optional array of Server Objects which provide connectivity information to a target server.
<a name="oasPaths"></a>paths | [Paths Object](#pathsObject) | **Required.** The available paths and operations for the API.
@@ -192,7 +192,7 @@ Field Name | Type | Description
This object can be extended with [Specification Extensions](#specificationExtensions).
-#### <a name="oasVersion"></a>OpenAPI Version String
+#### <a name="oasVersionString"></a>OpenAPI Version String
The version string signifies the version of the OpenAPI Specification that the document complies to. The format for this string MUST be `major`.`minor`.`patch`. The `patch` MAY be suffixed by a hyphen and extra alphanumeric characters.
@@ -410,6 +410,8 @@ Field Pattern | Type | Description
<a name="componentsLinks"></a> links | Map[`string`, [Link Object](#linkObject)] | An object to hold reusable [Link Objects](#linkObject).
<a name="componentsCallbacks"></a> callbacks | Map[`string`, [Callback Object](#callbackObject)] | An object to hold reusable [Callback Objects](#callbackObject).
+This object can be extended with [Specification Extensions](#specificationExtensions).
+
All the fixed fields declared above are objects that MUST use keys that match the regular expression: `[a-zA-Z0-9.\-_]+`.
Field Name Examples:
@@ -1076,10 +1078,12 @@ A free-form query parameter, allowing undefined parameters of a specific type:
{
"in": "query",
"name": "freeForm",
+ "schema": {
"type": "object",
"additionalProperties": {
"type": "integer"
},
+ }
"style": "form"
}
```
@@ -1087,6 +1091,7 @@ A free-form query parameter, allowing undefined parameters of a specific type:
```yaml
in: query
name: freeForm
+schema:
type: object
additionalProperties:
type: integer

various minor corrections.