поднимать swagger вместе с сервером, написанным на spring’е? Меня смутило большая колбаса аннотаций перед методами для описания.
Или же лучше отдельно описывать в json’е?
> spring > большая колбаса аннотаций перед методами да вроде бы все нормально?
С учетом текущего кол-ва, появляется еще больше😅
Если у вас подход contract first (и у него в целом много плюсов), то можно сначала описать openapi definition, а затем воспользоваться кодогенерацией Если же просто хотите документировать свое API, но никоиу раньше времени с ним особо интегрироваться не надо - да, пользуются аннотациями
Спасибо! Подскажи, а есть какие-либо годные статьи про подход contract-first? Хотелось бы по подробнее почитать) В моем случае, интеграций особо не будет)
https://habr.com/ru/company/yoomoney/blog/647441/
Обсуждают сегодня