{"id":"ia.docs-answer","name":"Docs pages that answer","verify":{"command":"curl -sL https://{domain}/docs | grep -c 'class=\"language-'","rescan":"isagentready results {domain} --checkpoint ia.docs-answer","expect":"a count above 0"},"fix":{"steps":[{"action":"Render the docs text in the server HTML, with at least a few paragraphs per page.","order":1,"language":null,"code_example":null},{"action":"Give each page an h1 and h2 or h3 headings.","order":2,"language":null,"code_example":null},{"action":"Tag each code block with its language.","order":3,"language":"html","code_example":"<pre><code class=\"language-bash\">curl https://api.example.com/v1/items</code></pre>"}],"summary":"Render docs pages on the server with headings and language-tagged code.","skill":{"name":"agent-protocols","anchor":"ia.docs-answer"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"agentready.org AR-READ-04","kind":"study","url":"https://www.agentready.org/#read"},{"title":"agentready.org AR-READ-05","kind":"study","url":"https://www.agentready.org/#read"}],"expected":"Docs pages with HTTP 200, server-rendered text, a heading structure and language-tagged code blocks","stage":"read","lifecycle":{"introduced":"2026-10-22","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-22","evidence_tier":"emerging","evidence_source":{"title":"agentready.org AR-READ-04","url":"https://www.agentready.org/#read"},"why":"Agents read docs pages as raw HTML and reuse code from them. In the agentready.org study, agents reached docs pages in most runs. A page that needs JavaScript, has no headings or shows untagged code gives the agent no usable answer.","profiles":["api_tool_readiness"],"score_role":"bonus","legacy_id":"4.30","i18n":{"nl":{"name":"Docspagina's die antwoord geven","steps":["Render de docstekst in de server-HTML, met minstens een paar alinea's per pagina.","Geef elke pagina een h1 en h2- of h3-koppen.","Tag elk codeblok met de taal."],"why":"Agents lezen docspagina's als ruwe HTML en hergebruiken code daaruit. In het onderzoek van agentready.org bereikten agents docspagina's in de meeste runs. Een pagina die JavaScript nodig heeft, geen koppen heeft of ongetagde code toont, geeft de agent geen bruikbaar antwoord.","fix_summary":"Render docspagina's op de server met koppen en code met een taaltag.","verify_expect":"een aantal boven 0"}},"ar_practice_ids":["AR-READ-04","AR-FIND-02","AR-READ-05"],"strength":"SHOULD","ar_mapping":"full","evidence_type":"measured_study","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.docs-answer","maturity":"emerging","applicability":{"mode":"detected_surface","condition":null,"surfaces":["api","mcp"]}}