Helen Kosova

**If all properties are optional, do not include the `required` keyword.** ```json "Formatting": { "type": "object", "properties": { "code": { "type": "string" } } }, ``` OpenAPI 2.0 uses a...

You need to add quotes around the example value: ```yaml type: string format: date example: '2019-02-01' #

@aldredb you can use `requestInterceptor` to proxy requests through a CORS proxy. See the example here: https://github.com/swagger-api/swagger-ui/issues/1888#issuecomment-173179594

You could use an [extension](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.3.md#specificationExtensions) such as `x-pii: true`.

Possibly related: #568

Describing non-object elements with attributes such as `a-b` will be possible with `x-oas-draft-alternativeSchema` (#1532) if that proposal is implemented.

@webron a literal string `$ref: "markdown/controls.md"` can be written as ```yaml description: >- "$ref": "markdown/controls.md" description: '"$ref": "markdown/controls.md"' # note the extra quotes around the string description: '"$ref": "markdown/controls.md"' #...

Related: #4749

@mu-majid this is not a pull request, it's a bug report.

This is probably the same issue as #5972 and https://github.com/swagger-api/swagger-js/issues/1425. The workaround suggested in those issues is to move `paths` before `components` in the OpenAPI file.