Question
You ask an AI to generate REST API reference docs from a Go HTTP service by reading the handler code. It produces a polished doc with endpoints, request/response examples, and status codes. Before publishing it to your public developer portal, how do you verify the docs are both accurate AND complete — and what gaps does an AI reading handlers tend to miss?
Treat the AI’s output as a draft to verify, not an answer to trust. Name the specific flaw and the input that triggers it, say how you’d catch it — tests, edge cases, reading critically — and how you’d re-prompt or decompose to get it right.
Vibe coding: describe the solution in plain language (or narrate it) and the coach grades your approach. Generating runnable code from your description is coming next.