Добавление комментариев к структуре данных в API Blueprint

Question

У меня есть два свойства, один из которых должен быть поставлен. Я пытался добавить комментарий в нижней части структуры данных, но он был проигнорирован. Так что я попробовал описание нескольких линий, но это также было проигнорировано:

# Data Structures 

## Record (object) 

+ ResponseId: `42f7b8b07da641bcb6d96422cb903c0e` (string, optional) - Identifier for the record being updated 
+ UniqueReference: 1 (number, optional) - Reference for the record being updated. 

    If both are supplied, response id will be used 

Answer 1

Добавить описание в верхней части и использовать member type separator, чтобы отделить его от свойств элементов.

Например.

# Data Structures 

## Record (object) 

If both are supplied, response id will be used 

### Properties 

- ResponseId: 42f7b8b07da641bcb6d96422cb903c0e (string, optional) - Identifier for the record being updated 
- UniqueReference: 1 (number, optional) - Reference for the record being updated.