У нас вы можете посмотреть бесплатно 2017.10.23 Евгений Маренков - Swagger: пишем документацию красиво! или скачать в максимальном доступном качестве, видео которое было загружено на ютуб. Для загрузки выберите вариант из формы ниже:
Если кнопки скачивания не
загрузились
НАЖМИТЕ ЗДЕСЬ или обновите страницу
Если возникают проблемы со скачиванием видео, пожалуйста напишите в поддержку по адресу внизу
страницы.
Спасибо за использование сервиса ClipSaver.ru
Swagger - это очень большая экосистема, предоставляющая огромное количество возможностей для документации REST API. Например, Swagger позволяет генерировать документацию из Java-кода, что позиционируется как очень модный подход. На личном опыте покажу, что этот подход очень нежелателен, и объясню на примерах, к каким плачевным последствиям он приведет. Расскажу про наш подход к этому зверю так, чтоб Java-код остался нетронутым, а документация была бы понятна как потенциальным клиентам REST API так и Product Owner-ам, которые тоже хотят в понятной для себя форме видеть и подправлять документацию.