Когда возвращаемый объект имеет универсальный тип, например List, а интерфейс определяет фактический возвращаемый тип как List, то при генерации документации User анализируется напрямую, а List игнорируется.