Skip to content

Commit dee224a

Browse files
committed
Updates based on Ron's feedback
1 parent 4ad1438 commit dee224a

File tree

1 file changed

+12
-17
lines changed

1 file changed

+12
-17
lines changed

versions/3.0.md

Lines changed: 12 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -57,10 +57,6 @@ Additional utilities can also take advantage of the resulting files, such as tes
5757
- [Reference Object](#reference-object)
5858
- [Schema Object](#schema-object)
5959
- [XML Object](#xml-object)
60-
- [Definitions Object](#definitions-object)
61-
- [Parameters Definitions Object](#parameters-definitions-object)
62-
- [Responses Definitions Object](#responses-definitions-object)
63-
- [Security Definitions Object](#security-definitions-object)
6460
- [Security Scheme Object](#security-scheme-object)
6561
- [Scopes Object](#scopes-object)
6662
- [Security Requirement Object](#security-requirement-object)
@@ -384,26 +380,26 @@ This object can be extended with [Specification Extensions](#specificationExtens
384380
#### <a name="componentsObject"></a>Components Object
385381

386382
Holds a set of reusable objects for different aspects of the OAS.
387-
All objects defined within the components object will have no effect on the API unless they are explicitly referenced from properties outside the components object.
383+
All objects defined within the components object will have no effect on the API unless they are explicitly referenced from properties outside the components object.
388384

389385

390386
##### Fixed Fields
391387

392388
Field Pattern | Type | Description
393-
---|:---:|---
394-
<a name="componentsDefinitions"></a> definitions | Map[`string`, [Schema Objects](#schemaObject)] | An object to hold reusable [Schema Objects](#schemaObject).
395-
<a name="componentsResponses"></a> responses | Map[`string`, [Responses Objects](#responseObject)] | An object to hold reusable [Responses Objects](#responseObject). This does *not* define global operation responses.
396-
<a name="componentsParameters"></a> parameters | Map[`string`, [Parameter Objects](#parameterObject)] | An object to hold reusable [Parameter Objects](#parameterObject). This does *not* define global operation parameters.
397-
<a name="componentsExamples"></a> examples | Map[`string`, [Example Objects](#exampleObject)] | An object to hold reusable [Example Objects](#exampleObject).
398-
<a name="componentsRequestBodies"></a> requestBodies | Map[`string`, [RequestBody objects](#requestBodyObject)] | An object to hold reusable [RequestBody objects](#requestBodyObject).
399-
<a name="componentsResponseHeaders"></a> responseHeaders | Map[`string`,[Response Headers objects](#headersObject)] | An object to hold reusable [Response Headers objects](#headersObject).
400-
<a name="componentsSecurityDefinitions"></a> securityDefinitions| Map[`string`, [Security Scheme objects](#securitySchemeObject)] | An object to hold reusable [Security Scheme objects](#securitySchemeObject).
401-
<a name="componentsLinks"></a> links | Map[`string`, [Link Objects](#linkObject)] | An object to hold reusable [Link Objects](#linkObject).
402-
<a name="componentsCallbacks"></a> callbacks | Map[`string`, [Callbacks Objects](#callbacksObject)] | An object to hold reusable [Callbacks Objects](#callbacksObject).
389+
---|:---|---
390+
<a name="componentsDefinitions"></a> definitions | Map[`string`, [Schema Object](#schemaObject)] | An object to hold reusable [Schema Objects](#schemaObject).
391+
<a name="componentsResponses"></a> responses | Map[`string`, [Response Object](#responseObject)] | An object to hold reusable [Responses Objects](#responseObject).
392+
<a name="componentsParameters"></a> parameters | Map[`string`, [Parameter Object](#parameterObject)] | An object to hold reusable [Parameter Objects](#parameterObject).
393+
<a name="componentsExamples"></a> examples | Map[`string`, [Example Object](#exampleObject)] | An object to hold reusable [Example Objects](#exampleObject).
394+
<a name="componentsRequestBodies"></a> requestBodies | Map[`string`, [RequestBody Object](#requestBodyObject)] | An object to hold reusable [RequestBody objects](#requestBodyObject).
395+
<a name="componentsResponseHeaders"></a> responseHeaders | Map[`string`, [Response Header object](#headersObject)] | An object to hold reusable [Response Headers objects](#headersObject).
396+
<a name="componentsSecurityDefinitions"></a> securityDefinitions| Map[`string`, [Security Scheme object](#securitySchemeObject)] | An object to hold reusable [Security Scheme objects](#securitySchemeObject).
397+
<a name="componentsLinks"></a> links | Map[`string`, [Link Object](#linkObject)] | An object to hold reusable [Link Objects](#linkObject).
398+
<a name="componentsCallbacks"></a> callbacks | Map[`string`, [Callbacks Object](#callbacksObject)] | An object to hold reusable [Callbacks Objects](#callbacksObject).
403399

404400
All the fixed fields declared above are objects that MUST use keys that match the regular expression: `[a-zA-Z0-9.\-_]+`.
405401

406-
Examples:
402+
Field Name Examples:
407403

408404
```
409405
User
@@ -419,7 +415,6 @@ my\org\User
419415
```json
420416
"components": {
421417
"definitions": {
422-
{
423418
"Category": {
424419
"type": "object",
425420
"properties": {

0 commit comments

Comments
 (0)