Updates based on Ron's feedback
MODIFY
versions/3.0.md
versions/3.0.md
@@ -57,10 +57,6 @@ Additional utilities can also take advantage of the resulting files, such as tes
- [Reference Object](#reference-object)
- [Schema Object](#schema-object)
- [XML Object](#xml-object)
- - [Definitions Object](#definitions-object)
- - [Parameters Definitions Object](#parameters-definitions-object)
- - [Responses Definitions Object](#responses-definitions-object)
- - [Security Definitions Object](#security-definitions-object)
- [Security Scheme Object](#security-scheme-object)
- [Scopes Object](#scopes-object)
- [Security Requirement Object](#security-requirement-object)
@@ -390,20 +386,20 @@ All objects defined within the components object will have no effect on the API
##### Fixed Fields
Field Pattern | Type | Description
----|:---:|---
-<a name="componentsDefinitions"></a> definitions | Map[`string`, [Schema Objects](#schemaObject)] | An object to hold reusable [Schema Objects](#schemaObject).
-<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.
-<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.
-<a name="componentsExamples"></a> examples | Map[`string`, [Example Objects](#exampleObject)] | An object to hold reusable [Example Objects](#exampleObject).
-<a name="componentsRequestBodies"></a> requestBodies | Map[`string`, [RequestBody objects](#requestBodyObject)] | An object to hold reusable [RequestBody objects](#requestBodyObject).
-<a name="componentsResponseHeaders"></a> responseHeaders | Map[`string`,[Response Headers objects](#headersObject)] | An object to hold reusable [Response Headers objects](#headersObject).
-<a name="componentsSecurityDefinitions"></a> securityDefinitions| Map[`string`, [Security Scheme objects](#securitySchemeObject)] | An object to hold reusable [Security Scheme objects](#securitySchemeObject).
-<a name="componentsLinks"></a> links | Map[`string`, [Link Objects](#linkObject)] | An object to hold reusable [Link Objects](#linkObject).
-<a name="componentsCallbacks"></a> callbacks | Map[`string`, [Callbacks Objects](#callbacksObject)] | An object to hold reusable [Callbacks Objects](#callbacksObject).
+---|:---|---
+<a name="componentsDefinitions"></a> definitions | Map[`string`, [Schema Object](#schemaObject)] | An object to hold reusable [Schema Objects](#schemaObject).
+<a name="componentsResponses"></a> responses | Map[`string`, [Response Object](#responseObject)] | An object to hold reusable [Responses Objects](#responseObject).
+<a name="componentsParameters"></a> parameters | Map[`string`, [Parameter Object](#parameterObject)] | An object to hold reusable [Parameter Objects](#parameterObject).
+<a name="componentsExamples"></a> examples | Map[`string`, [Example Object](#exampleObject)] | An object to hold reusable [Example Objects](#exampleObject).
+<a name="componentsRequestBodies"></a> requestBodies | Map[`string`, [RequestBody Object](#requestBodyObject)] | An object to hold reusable [RequestBody objects](#requestBodyObject).
+<a name="componentsResponseHeaders"></a> responseHeaders | Map[`string`, [Response Header object](#headersObject)] | An object to hold reusable [Response Headers objects](#headersObject).
+<a name="componentsSecurityDefinitions"></a> securityDefinitions| Map[`string`, [Security Scheme object](#securitySchemeObject)] | An object to hold reusable [Security Scheme objects](#securitySchemeObject).
+<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`, [Callbacks Object](#callbacksObject)] | An object to hold reusable [Callbacks Objects](#callbacksObject).
All the fixed fields declared above are objects that MUST use keys that match the regular expression: `[a-zA-Z0-9.\-_]+`.
-Examples:
+Field Name Examples:
```
User
@@ -419,7 +415,6 @@ my\org\User
```json
"components": {
"definitions": {
- {
"Category": {
"type": "object",
"properties": {

Updates based on Ron's feedback