Earlier quoted context omitted.
It’s pretty true, someone today on here wrote, “teach it to understand swagger”, I actually laughed, like I’ve used swagger and it often turns into a Frankenstein, and sometimes for good reason. I completely understand the sentiment and I like swagger. I believe the world is wiggly, not geometrically perfect, intellectuals struggle with that because square problems are easier to solve. Ideal scenarios are predictable…
Actually chat gpt is quite good at understanding some kinds of wiggliness. I built a restful api and documented it in a readme.md file in the wiggliest of ways. I then asked chatgpt to turn the readme into a swagger spec and then give me a page that read the spec and gave me a nice doc page with api exercise tool. Both tasks it performed really well and saved me a whole bunch of time.
It failed spectacularly
I wonder if it's because the API is quite large, and I had to paste in ~10 messages worth of API docs before I was finished.
It kept repeating segments of the same routes/paths and wasn't able to provide anything cohesive or useful to me.
Was your API pretty small? Or were your docs pretty concise?