Text cleanup

Author: darrelmiller

versions/3.0.md

@@ -50,7 +50,7 @@ Additional utilities can also take advantage of the resulting files, such as tes
 		- [Links Object](#linksObject)
 		- [Link Object](#linkObject)
 		- [Variable substitution](#variableSubstitution)
-		- [Link Parameters](#linkParameters)
+		- [Link Parameters](#linkParametersObject)
 		- [Header Object](#headerObject)
 		- [Tag Object](#tagObject)
 		- [Examples Object](#examplesObject)
@@ -384,22 +384,22 @@ This object can be extended with [Specification Extensions](#specificationExtens
 #### <a name="componentsObject"></a>Components Object
 
 Holds a set of reusable objects for different aspects of the OAS.
-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.  
+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.
 
 
 ##### Fixed Fields
 
 Field Pattern | Type | Description
 ---|:---|---
 <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="componentsResponses"></a> responses | Map[`string`, [Response Object](#responseObject)] | An object to hold reusable [Response 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="componentsRequestBodies"></a> requestBodies | Map[`string`, [Request Body Object](#requestBodyObject)] | An object to hold reusable [Request Body Objects](#requestBodyObject).
 <a name="componentsHeaders"></a> headers | Map[`string`, [Header object](#headerObject)] | An object to hold reusable [Header objects](#headerObject).
-<a name="componentsSecurityDefinitions"></a> securityDefinitions| Map[`string`, [Security Scheme object](#securitySchemeObject)] | An object to hold reusable [Security Scheme objects](#securitySchemeObject).
+<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`, [Callback Object](#callbackObject)] | An object to hold reusable [Callback Object](#callbackObject).
+<a name="componentsCallbacks"></a> callbacks | Map[`string`, [Callback Object](#callbackObject)] | An object to hold reusable [Callback Objects](#callbackObject).
 
 All the fixed fields declared above are objects that MUST use keys that match the regular expression: `[a-zA-Z0-9.\-_]+`.
 
@@ -451,16 +451,20 @@ my\org\User
       "in": "query",
       "description": "number of items to skip",
       "required": true,
-      "type": "integer",
-      "format": "int32"
+      "schema": {
+        "type": "integer",
+        "format": "int32"
+      }
     },
     "limitParam": {
       "name": "limit",
       "in": "query",
       "description": "max records to return",
       "required": true,
-      "type": "integer",
-      "format": "int32"
+      "schema" : {
+        "type": "integer",
+        "format": "int32"
+      }
     }
   },
   "responses": {
@@ -528,15 +532,17 @@ components:
       in: query
       description: number of items to skip
       required: true
-      type: integer
-      format: int32
+      schema:
+        type: integer
+        format: int32
     limitParam:
       name: limit
       in: query
       description: max records to return
       required: true
-      type: integer
-      format: int32
+      schema:
+        type: integer
+        format: int32
   responses:
     NotFound:
       description: Entity not found.
@@ -1675,7 +1681,7 @@ description: object created
 #### <a name="callbacksObject"></a>Callbacks Object
 
 A map of possible out-of band callbacks related to the parent operation.
-Each value in the map is an [Callback Object](#callbackObject) that describes a request that may be initiated by the API provider and the expected responses.
+Each value in the map is a [Callback Object](#callbackObject) that describes a request that may be initiated by the API provider and the expected responses.
 The key value used to identify the callback object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.
 
 ##### Patterned Fields
@@ -1694,13 +1700,13 @@ The key value used to identify the callback object is an expression, evaluated a
 ##### Patterned Fields
 Field Pattern | Type | Description
 ---|:---:|---
-<a name="callbackExpression"></a>{expression} | [Path Item Object](#pathItemObject) | An Path Item Object used to define a callback request and expected responses
+<a name="callbackExpression"></a>{expression} | [Path Item Object](#pathItemObject) | A Path Item Object used to define a callback request and expected responses
 
 This object can be extended with [Specification Extensions](#specificationExtensions). 
 
 ##### Key Expression
 
-The key used to identify the Path Item Object is a variable expression that can be evaluated in the context of a runtime HTTP request/response to identify the URL to be used for the callback request.
+The key used to identify the [Path Item Object](#pathItemObject) is a variable expression that can be evaluated in the context of a runtime HTTP request/response to identify the URL to be used for the callback request.
 A simple example might be `$request.body#/url`.
 However, using [variable substitution](#variableSubstitution) syntax the complete HTTP message can be accessed.
 This includes accessing any part of a body that can be accessed using a JSON Pointer [RFC6901](https://tools.ietf.org/html/rfc6901). 
@@ -1865,7 +1871,7 @@ Field Name  |  Type  | Description
 ---|:---:|---
 href        | `string`    | a relative or absolute URL to a linked resource. This field is mutually exclusive with the `operationId` field.
 operationId | `string` | the name of an _existing_, resolvable OAS operation, as defined with a unique `operationId`.  This field is mutually exclusive with the `href` field.  Relative `href` values MAY be used to locate an existing Operation Object in the OAS.
-parameters  | [Link Parameters Object](#linkParameters) | an object representing parameters to pass to an operation as specified with `operationId` or identified via `href`.
+parameters  | [Link Parameters Object](#linkParametersObject) | an object representing parameters to pass to an operation as specified with `operationId` or identified via `href`.
 headers     | [Headers Object](#headersObject)    | an object representing headers to pass to the linked resource. Where conflicts occur between these headers, and those defined in the related operation, these headers override.
 description | `string` | a description of the link, supports [CommonMark syntax](http://spec.commonmark.org/).
 
@@ -2241,7 +2247,7 @@ components:
 ```
 
 
-### <a name="linkParameters"></a>Link Parameters
+### <a name="linkParametersObject"></a>Link Parameters Object
 Using the `operationId` to reference an operation in the definition has many benefits, including the ability to define media-type options, security requirements, response and error payloads.
 Many operations require parameters to be passed, and these MAY be dynamic depending on the response itself.