← methodology

Docs discoverable

usability.docs-discovery · Usability · 4 pts · required

Goal

Can an agent integrate with you?

Whether the artifacts an agent needs to build on you — docs, API specs, SDKs, MCP servers — exist and are findable.

How we test

Followed homepage nav/footer links and probed /docs, /developers, docs.{domain}.

How to pass

Expose public docs at /docs or docs.{domain} and link them from your homepage nav.

Verify a fix

curl -X POST /api/scan/checks \
  -H 'content-type: application/json' \
  -d '{"url": "yourdomain.com", "checkIds": ["usability.docs-discovery"]}'