Working now
What already works.
- URL Stability and Redirects is relatively strong at 100/100.
- Authentication and Access is relatively strong at 100/100.
- Content Structure is relatively strong at 100/100.
Benchmark report
Docs benchmark report.
Report for
maesndocs.maesn.com
This report shows where agents can use these docs cleanly and where the biggest points of friction still are.
Benchmark score
97Grade A
This report passes 16 of 22 checks, with 1 warnings, 4 failed checks, and 1 skipped checks still shaping the next score lift.
- Checks passed
- 16/22
- Warnings
- 1
- Failed checks
- 4
Key takeaways
What stands out first.
Start with what already works, then move to the fixes most likely to lift the score.
Improve next
What to improve next.
- Markdown Content Parity in Observability and Content Health.
- Page Size Markdown in Page Size and Truncation Risk.
- Page Size Html in Page Size and Truncation Risk.
Check results
Full score breakdown
Open each category to review the checks behind the score and see exactly where agents still hit friction.
Page Size and Truncation Risk2 passed2 failedCan an agent read the page without losing important context?
Page Size and Truncation Risk
2 passed2 failed
Can an agent read the page without losing important context?
2 failed checks still shape this area.
Rendering Strategy
All 10 sampled pages contain server-rendered content
Page Size Markdown
1 of 10 pages exceed 100K chars (max 123K)
Page Size Html
1 of 10 sampled pages convert to over 100K chars (max 123K, 0% boilerplate)
Content Start Position
Content starts within first 10% on all 10 sampled pages (median 1%)
Observability and Content Health2 passed1 failedCan an agent tell whether the docs are fresh and trustworthy?
Observability and Content Health
2 passed1 failed
Can an agent tell whether the docs are fresh and trustworthy?
1 failed check still shape this area.
LLMS TXT Freshness
llms.txt covers 100% of 189 sitemap doc pages; 3 llms.txt links not in sitemap (may indicate stale links or incomplete sitemap)
Markdown Content Parity
1 of 10 pages have substantive content differences between markdown and HTML (avg 8% missing)
Cache Header Hygiene
All 12 endpoints have appropriate cache headers
URL Stability and Redirects2 passedCan an agent trust that URLs will stay predictable?
URL Stability and Redirects
2 passed
Can an agent trust that URLs will stay predictable?
This area is already one of the stronger parts of the report.
Http Status Codes
All 10 sampled pages return proper error codes for bad URLs
Redirect Behavior
No redirects detected across 10 sampled pages
Authentication and Access1 passed1 skippedCan an agent access the docs without getting blocked?
Authentication and Access
1 passed1 skipped
Can an agent access the docs without getting blocked?
1 check were skipped in this report.
Auth Gate Detection
All 10 sampled pages are publicly accessible
Auth Alternative Access
All docs pages are publicly accessible; no alternative access paths needed
Content Structure3 passedCan an agent understand how the page is organized?
Content Structure
3 passed
Can an agent understand how the page is organized?
This area is already one of the stronger parts of the report.
Tabbed Content Serialization
No tabbed content detected across 10 sampled pages
Section Header Quality
No tabbed content found; header quality check not applicable
Markdown Code Fence Validity
All 10 code fences properly closed across 12 pages
Markdown Availability2 passedCan an agent fetch a clean text version of the docs?
Markdown Availability
2 passed
Can an agent fetch a clean text version of the docs?
This area is already one of the stronger parts of the report.
Markdown Url Support
10/10 sampled pages support .md URLs (100%)
Content Negotiation
10/10 sampled pages support content negotiation (100%)
Content Discoverability4 passed1 warnings1 failedCan an agent find the right starting point?
Content Discoverability
4 passed1 warnings1 failed
Can an agent find the right starting point?
1 failed check still shape this area.
LLMS TXT Exists
llms.txt found at 2 location(s)
LLMS TXT Valid
llms.txt contains parseable links but doesn't fully follow the proposed structure: Https://docs.maesn.com/llms.txt: No blockquote summary found; https://docs.maesn.com/llms.txt: No blockquote summary found
LLMS TXT Size
llms.txt is 25,349 characters (under 50,000 threshold)
LLMS TXT Links Resolve
Only 9/10 same-origin sampled links resolve (90%); 1 broken
LLMS TXT Links Markdown
10/10 same-origin sampled links point to markdown content (100%) (1 external link excluded)
LLMS TXT Directive (HTML)
llms.txt directive found in all 10 sampled pages, near the top of content
Next steps
Get this report in your inbox or track the score over time.
Save the report to a work email now, or tell us what kind of ongoing monitoring would be useful for this docs site.
Built by DocsAlot
Need help improving the score?
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.