Linear scored 91/100 on the DocsAlot benchmark report across 22 published checks. This Documentation benchmark shows where agents can use these docs cleanly and where the biggest points of friction still are.
This report passes 18 of 22 checks, with 0 warnings, 3 failed checks, and 1 skipped checks still shaping the next score lift.
Documentation quality now affects implementation speed, support load, and whether an agent or buyer can stay self-serve. This benchmark shows where the docs already work well and where they still introduce friction.
Good documentation is discoverable, readable in plain text, clear about structure and instructions, and specific enough in examples and next steps that real workflows can keep moving.
These are the clearest signals behind the current score. Start with the strengths that already support discovery and implementation, then use the gaps below to prioritize the fixes most likely to improve AI readability and self-serve onboarding.
For the broader pattern behind these wins, review AI-readable documentation and compare this page with the full docs benchmark leaderboard.
If you want to improve the system behind these gaps, start with API docs automation, the OpenAPI to CLI generator, and this guide to making docs AI-readable.
Open each category to review the checks behind the score and see exactly where agents still hit friction.
Can an agent read the page without losing important context?
All 10 sampled pages contain server-rendered content
All 10 pages under 50K chars (median 6K, max 9K)
All 10 sampled pages convert under 50K chars (median 6K, 0% boilerplate)
Content starts within first 10% on all 10 sampled pages (median 0%)
Can an agent tell whether the docs are fresh and trustworthy?
llms.txt covers 98/130 sitemap doc pages (75%); 32 missing
5 of 10 pages have substantive content differences between markdown and HTML (avg 20% missing)
All 11 endpoints have appropriate cache headers
Can an agent trust that URLs will stay predictable?
All 10 sampled pages return proper error codes for bad URLs
No redirects detected across 10 sampled pages
Can an agent access the docs without getting blocked?
All 10 sampled pages are publicly accessible
All docs pages are publicly accessible; no alternative access paths needed
Can an agent understand how the page is organized?
No tabbed content detected across 10 sampled pages
No tabbed content found; header quality check not applicable
All 22 code fences properly closed across 11 pages
Can an agent fetch a clean text version of the docs?
10/10 sampled pages support .md URLs (100%)
10/10 sampled pages support content negotiation (100%)
Can an agent find the right starting point?
llms.txt found at 1 location(s)
llms.txt follows the proposed structure (H1, blockquote, heading-delimited link sections)
llms.txt is 9,026 characters (under 50,000 threshold)
All 10 same-origin sampled links resolve (126 total links)
10/10 same-origin sampled links point to markdown content (100%) (2 external links excluded)
No llms.txt directive found in any of 10 sampled pages
Save the report to a work email now, or tell us what kind of ongoing monitoring would be useful for this docs site.
Compare related benchmark reports, then move into the guides and tools that improve documentation benchmark scores.
99/100 score in Productivity. Open the full documentation benchmark report.
92/100 score in Productivity. Open the full documentation benchmark report.
91/100 score in Productivity. Open the full documentation benchmark report.
Compare this documentation benchmark report with other public docs benchmark results.
Score your own API docs or developer docs and open the full public report.
See how docs, SDKs, CLIs, and agent-facing outputs can ship from one OpenAPI-driven system.
Use the CLI page when the benchmark gaps are really onboarding and implementation gaps.
Use this guide when you want to improve the same categories this benchmark scores.
DocsAlot helps teams improve help centers, developer docs, API docs, and CLI docs so they are easier for humans to use and easier for agents to read.