Which editor do you use to edit Swagger? Writing Swagger specification by hand is a nightmare because of the poor online editor. The error messages are hard to understand.

Also Swagger.io people decided to replace the old editor with the new editor and it doesn't have many useful features the old has. Thankfully they kept the old one live.

Swagger is not all that hard to understand. This is a fantastic tutorial which helped a lot to get started: https://apihandyman.io/writing-openapi-swagger-specification...