OpenAPI vs Swagger: заметки по документированию API

Почитал тут статью про OpenAPI и про то, как ребята над ним свою обертку сделали. Занимательно, потом попробую собрать их проект и внимательно посмотреть, но в целом не увидел сильных преимуществ перед сваггером. Ты один раз делаешь документ, а дальше корюпируешь куски и все ок, или вообще генерирует из кода, если API first. А если у тебя настолько с арый фреймворк, что не поддерживает openAPI, то может и не надо не нем делать описание или уже поменять на что то современнее. https://habr.com/ru/articles/732572/. А у вас были проблемы с документированием API?