С генерацией проблем не было. На выходе swagger.json скармливаем вот этой штуке https://swagger.io/tools/swagger-ui/ Frontend разработчики не жалуются. По поводу хорошести реализации спецификации ни чего сказать не могу. Утилитки для описания API едят и рендерят нормально.
Обсуждают сегодня