Заинтересовало, что тот код что я видел, у наверное 90++% джун/миддл специалистов, не содержит даже попыток описывать свой сервис аннотациями для пользователя (коды ответов, семантику методов, интервалы параметров, не говоря уже о просто текстовых описаниях что методы делают). У сеньоров - я бы сказал что 50% тоже не делают практически ничего.
Этому не учат? Не акцентируют внимания? Не упоминают в книгах и статьях? Почему так?
чем плохо иметь армию безграмотных разработчиков? их как раз за умеренную плату нанимают госкорпорации, банки, федеральные торговые сети. Тем ценнее штучные специалисты ультракласса, которые вытаскивают проект из любой жопосрани и переходят к следующему. Бизнесу плевать, что творится внутри его процессов, пока он получает свою норму прибыли. Системе тем более все равно, она только прекрывается очередной серией инновационных нац.проектов для распила бюджета.