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

[vmorsk]

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

[Android1983]

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

[rexer]

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

[itdude]

Кроме менеджеров статья может быть полезна начинающим разработчикам. Мне сегодня встретился термин OpenAPI и я пошёл в поиск, чтобы узнать, что это такое. Яндекс на первых шести позициях выдал 3 страницы на английском (оф. сайт, статья вики и гитхаб). На такие ресурсы я перехожу, когда нужно не поверхностно познакомиться, а более подробно. Три других - статья вики на русском, эта статья и сайт с курсами хекслет. У хекслета описание мне больше всего понравилось, но там она не совсем в свободном доступе (требуется регистрация, а дальше может и денег попросят). А эта статья на втором месте - то есть, тоже вполне неплохая.

[ivvi]

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

[DoooMer]

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