{"id":"ia.developer-docs-link","name":"Developer docs discoverability","verify":{"command":"curl -sI https://{domain}/docs","rescan":"isagentready results {domain} --checkpoint ia.developer-docs-link","expect":"HTTP 200 for the documentation root"},"fix":{"steps":[{"action":"Add a link to /docs or /developers in the main navigation or the footer.","order":1,"language":"html","code_example":"<a href=\"/docs\">Developer documentation</a>"},{"action":"Add a service-doc Link header that points to the same documentation.","order":2,"language":"text","code_example":"Link: </docs>; rel=\"service-doc\""}],"summary":"Link your developer documentation from the home page with a clear link text.","skill":{"name":"agent-protocols","anchor":"ia.developer-docs-link"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"RFC 8288 service-doc link relation","kind":"guide","url":"https://www.iana.org/assignments/link-relations/link-relations.xhtml"}],"stage":"find","lifecycle":{"introduced":"2026-08-25","revised":["2026-09-02"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-22","evidence_tier":"emerging","evidence_source":{"title":"agentready.org AR-FIND-02","url":"https://www.agentready.org/#reachable"},"why":"Agents and developers look for /docs, /developers or /api links on the home page to find how to integrate. An API that is only discoverable through well-known files is easy to miss.","profiles":["api_tool_readiness"],"score_role":"bonus","legacy_id":"4.24","i18n":{"nl":{"name":"Vindbaarheid van developerdocs","steps":["Voeg een link naar /docs of /developers toe aan de hoofdnavigatie of de footer.","Voeg een service-doc-Link-header toe die naar dezelfde documentatie verwijst."],"why":"Agents en developers zoeken op de homepage naar links zoals /docs, /developers of /api. Een API die alleen via well-known-bestanden vindbaar is, wordt snel gemist.","fix_summary":"Link je developerdocumentatie vanaf de homepage met een duidelijke linktekst.","verify_expect":"HTTP 200 voor de startpagina van de documentatie"}},"ar_practice_ids":["AR-FIND-02","AR-READ-04"],"strength":"MAY","ar_mapping":"partial","evidence_type":"measured_study","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.developer-docs-link","maturity":"emerging","applicability":{"mode":"detected_surface","condition":null,"surfaces":["api","mcp"]}}