У нас в продукте для взаимодействия между фронтом и беком используется REST.

Ранее у нас в команде проектирование и описание методов чаще было задачей разработчиков-джунов. И меня это, честно говоря, расстраивало. Но в этом году вся работа досталась аналитикам.

В команде не все коллеги-аналитики работали раньше с REST, и еще меньше описывали спецификацию в Swagger. А я увидела возможность позаниматься любимым типом задач, помочь разобраться другим и внедрить комплексный подход при работе с REST API.

На самом последнем этапе этих работ у меня возникла сложность.

Я изучала синтаксис YAML на практике методом проб и ошибок. Это позволяло мне решать поставленные задачи, но объяснить синтаксис другим у меня не вышло.

Внезапно несколько дней назад на хабре выложили статью, которая подробно этот синтаксис разжёвывает. Люблю такие совпадения. Очень рекомендую всем, кто работает со Swagger.
Статья про Swagger и OpenAPI здесь