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/ ht

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/ https://swagger.io/docs/specification/basic-structure/): it’s not pleasant to work with.