Thanks for your quick and concise reply.
I respect your opinion on this, however the OpenAPI spec has been useful for many years before AI (which I'd never mentioned) was in the picture. The tooling I speak of is utilizing API clients (Postman, Bruno…etc), and more importantly leveraging such specs to enforce type safety out of the box.
For example… openapi.spec → openapi-ts → generates a typesafe SDK of the LimeLM API. (assuming the spec is written correctly).
As for generated slop… I've instead created an initial spec off your HTML (via an agent), and will refine it manually to match the documents for my needs. Its only slop if you let it become so.
Best.