Docs pages that answer

ia.docs-answer · 4.30

Read SHOULD Measured study AR-READ-04 AR-FIND-02 AR-READ-05 AgentReady requirement

Why it matters

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.

How to fix it

Render docs pages on the server with headings and language-tagged code.

Render the docs text in the server HTML, with at least a few paragraphs per page.
Give each page an h1 and h2 or h3 headings.

Tag each code block with its language.

<pre><code class="language-bash">curl https://api.example.com/v1/items</code></pre>

Verify

curl -sL https://{domain}/docs | grep -c 'class="language-'

Expected: a count above 0

Run a new scan for this checkpoint:

isagentready results {domain} --checkpoint ia.docs-answer

Details Mapping, lifecycle and references

AR mapping: Direct relation
Evidence source: agentready.org AR-READ-04
Score role: Bonus
Introduced: 2026-10-22
Revised: 2026-10-30
Methodology version: 2026-10-30

Checkpoint data (JSON)