Skip to content

Заполнение summary и description #8

@kuzyara

Description

@kuzyara

Сейчас summary заполняется из реквизита Комментарий, а description из описание метода в коде.
Плюс description это дополнительное поле в раскрывающемся блоке, а summary - основное и всегда на виду.
Плюс описание метода в первую очередь делается в коде, а реквизит Комментарий почти всегда и везде заполнен по остаточному принципу, если вообще заполнен.
Плюс не заполнить описание метода в коде нельзя, т.к. на это вообще весь парсинг завязан

Даже на официальном примере description почти нигде не заполнен, а summary наоборот везде есть:
https://petstore.swagger.io/?_ga=2.101684097.1076944309.1599460549-57865753.1599460549#/user/createUser
image

Так что предлагаю сделать заполнение этих полей наоборот. Вооот

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions