Введение в OpenAPI: ёмко и полезно о важном

[vmorsk]

Сбер... Сначала они рассказывают тебе о высоких стандартах и оптимизации, а потом скидывают вордовский файлик на 100 строк вместо документации полу рабочего сервиса 😁

[Android1983]

Соглашусь и дополню. Статья конечно заманчивая но как всем этим пользоваться совершенно не понятно. Ну да есть Git и да есть информационный сайт и что дальше.
Я если честно до сих пор в этом Open Source разобраться не могу.

[rexer]

Не очень понимаю целевую аудиторию для статьи, она больше выглядит как обоснование для менеджера, чтобы мы это сделали. Для разработчика же этот материал почти бессмысленный, на мой взгляд.

[ivvi]

Поддерживает ли последняя версия OpenAPI $ref-ссылки в JSON-схемах?

[DoooMer]

Если правильно понял вопрос, то речь о ссылках на схемы внутри документа. Мы обычно используем yaml, но в json $ref работает так же.