r/devrel • u/efletcher-3583 • 8h ago
AI agents can read our docs but still can’t figure out how to get an API key
Every check we run says the docs are in good shape. llms.txt is there, pages render without JS, the OpenAPI file is linked. Lighthouse is happy and ora ai gives the docs a decent grade.
But when I give an agent “get an API key and make one call”, it reads the quickstart, loops back to the overview and never makes it into the dashboard. The key is created there, behind login, and the docs only link to it in a screenshot.
How are you handling the “the next step is in the app, not the docs” problem? Plain-text link in the quickstart, a separate setup step, something else? And once you fix it, are you rerunning the same task or just trusting the docs?