{"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":["2026-10-30"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"emerging","evidence_source":{"title":"agentready.org AR-READ-04","url":"https://www.agentready.org/#read"},"why":"Server-rendered docs, headings and tagged code help agents retrieve information. These structural checks do not establish that the page answers a user task accurately or completely.","profiles":["api_tool_readiness"],"score_role":"bonus","ar_strengths":{"AR-FIND-02":"SHOULD","AR-READ-04":"SHOULD","AR-READ-05":"SHOULD"},"ar_practice_ids":["AR-READ-04","AR-FIND-02","AR-READ-05"],"legacy_id":"4.30","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.docs-answer","strength_source":"agentready","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":"Server-gerenderde docs, koppen en code met taaltags helpen agents informatie te vinden. Deze structuurchecks bewijzen niet dat de pagina een gebruikerstaak juist of volledig beantwoordt.","verify_expect":"een aantal boven 0","fix_summary":"Render docspagina's op de server met koppen en code met een taaltag."}},"maturity":"emerging","applicability":{"mode":"detected_surface","condition":null,"surfaces":["website"]},"strength":"SHOULD","ar_mapping":"full","evidence_type":"measured_study"}