It is supposed to be read by humans: "The format is easy to learn and readable to both humans and machines."

Source https://swagger.io/docs/specification/about

But it's to supposed to be written by humans