Introduced prefix and separator

Author: darrelmiller

versions/3.0.md

@@ -647,16 +647,25 @@ Field Name | Type | Description
 <a name="parameterRequired"></a>required | `boolean` | Determines whether this parameter is mandatory. If the parameter is [`in`](#parameterIn) "path", this property is **required** and its value MUST be `true`. Otherwise, the property MAY be included and its default value is `false`. 
 <a name="parameterDeprecated"></a> deprecated | `boolean` | Specifies that a parameter is deprecated and should be transitioned out of usage.
 <a name="parameterSchema"></a>schema | [Schema Object](#schemaObject) | The schema defining the type used for the parameter.
-<a name="parameterEscape"></a>escape | `boolean` | Determines whether the parameter value should have unallowed characters percent-encoded based the parameter ___location. The default value is `true`.
-<a name="parameterStyle"></a>style | `string` | Determines rendering rules based on [RFC 6570](https://tools.ietf.org/html/rfc6570). Valid values include "matrix", "label", "segment", "simple".  The style is only used when `in` has the value `path`. "matrix" refers to what RFC6570 calls "path-style".  Default value is "simple".
+<a name="parameterEscape"></a>escape | `boolean` | Determines whether the parameter value should have unallowed characters percent-encoded based the parameter ___location. This property only applies to parameters with an `in` value of `query`. The default value is `true`.
+<a name="parameterPrefix"></a>style | `string` | Defines a character to prefix each parameter value. Valid values include [;.].  Where no separator is specified and a parameter value is an array, then a comma will be used as the default separator.  
+<a name="parameterSeparator"></a>style | `string` | Defines a character used to separate the values of parameters that are lists and maps. Value values include [;.].  Where no separator is specified and a parameter value is an array, then a comma will be used as the default separator.  
 <a name="parameterExplode"></a>explode | `boolean` | Indicates if the parameter values should rendered using the rules of the explode operator as defined in [RFC 6570](https://tools.ietf.org/html/rfc6570#section-2.2).  Default value is `false`.  
 
-
 ##### Patterned Fields
 Field Pattern | Type | Description
 ---|:---:|---
 <a name="parameterExtensions"></a>^x- | Any | Allows extensions to the OpenAPI Schema. The field name MUST begin with `x-`, for example, `x-internal-id`. The value can be `null`, a primitive, an array or an object. See [Specification Extensions](#specificationExtensions) for further details.
 
+##### Parameter Value Rendering Examples
+
+path | escape | prefix | separator | explode | Value | Output
+---|:---:|---:|---:|---:|---:|---:|
+/share/myfile{ext} | true | . |   | false | jpg | /share/myfile.jpg
+/registerwebhook?url={callback} | false |   |   | false | http://example.org/myreceiver | /registerwebhook?url=http://example.org/myreceiver
+/letters?value={value} | true |   | ,  | false | [a,b,c] | /letters?value=a,b,c
+/letters?value={value} | true |   | ,  | true | [a,b,c] | /letters?value=a&value=b,c
+
 
 ##### Parameter Object Examples