У меня проблема с записью файла swagger. Когда я описываю параметр, описание перегружается описанием $ref этого же параметра (см. пример ниже).
a-body:
description: The body
type: object
properties:
my_param:
description: Full description
$ref: '#/definitions/reference'
definitions:
reference:
type: object
required: [req]
description: an http reference
properties:
req:
type: string
Результат: описание перегружено
Может кто-нибудь помочь мне пройти через это, пожалуйста?