Personally, I find it very cumbersome. Just look at the very first example they show on their website (https://swagger.io/docs/specification/basic-structure/): it’s not pleasant to work with.