ContributionsMost RecentMost LikesSolutionsRe: $ref and description/title Thanks! As I understand, version 3.1 is not released yet? Do you know anything about planned release date? Re: $ref and description/title ... or even this (which I found on Internet): myProperty: description: My description allOf: - $ref: '#/components/schemas/MyType' $ref and description/title The page https://swagger.io/docs/specification/using-ref/ says that when I am using $ref in an OpenAPI spec all sibling properties are ignored. It is not quite clear if there is a way to workaround this issue. Can I use for example myProperty: allOf: - $ref: '#/components/schemas/MyType' - description: My description ? Solved