[BUG] description should not be used next to $ref

[canvural]

API Version

1.0

Summary

This is issue is about a technical point in regards to OpenAPI spec. $ref values should not have any siblings. More information can be found here and here.

Couple of examples of this usage in TOMP-API can be seen here and here.

This usage causes errors with some tools.

Expected Behavior

$ref values should not have any sibling.

Current Behavior

Writing siblings next to $ref causes some tools to throw error when parsing TOMP-API spec.

Possible Solution

As described here, one possible solution is to allOf keyword.

So this example can be converted to:

from:
    description: The departure location of this leg, using this asset type
    allOf:
        - $ref: "#/components/schemas/place"

I can create a PR that fixes this, if you agree.