Как мы сломали старую хибару и построили на ее месте небоскреб

Проект развивался постоянно. Задачи расширения функционала и переезда решались параллельно. Сначала занимался только я: набросал скелеты основных сервисов, написал базовую логику. Подготовил почву для реализации новых фич, обособленных от основного кода, уже в новой среде. Далее к процессу постепенно подтянулась вся команда. Весь новый функционал создавался сразу в новой версии. Это обсуждалось с заказчиком, на задачи выделялось больше времени, в их рамках создавались общие компоненты и фундаментальные вещи для дальнейшей разработки. В каждый спринт (по крайней мере мы старались брать в каждый) закладывались технические задачи, невидимые для заказчика. Но, так как проект бизнесовый, периодически приходили срочные таски, например, быстро сделать страницу для новой акции, которая стартует на следующей неделе. Тут уже не до красоты, делали в старой версии приложения, выкидывали в прод, а через несколько недель, после окончания акции, просто забывали про этот код. Отсюда и такой срок на переезд. Фактически в единицу времени над ним работали только 1-2 человека. Постепенно это цифра росла, и старый код уже менялся крайне редко. Иногда по несколько спринтов туда не приходилось залезать.

Как мы сломали старую хибару и построили на ее месте небоскреб

Swagger UI мы все знали, и он нас устраивал полностью. Со Spring REST Docs у меня лично опыта работы не было. А так как нового для нас уже было достаточно, и это все-таки не ключевой функционал, оставили привычное решение.