Mintlify

Pages point agents to llms.txt

llms.txt directive found in HTML of 10 of 14 sampled pages (4 missing); 1 failed to fetch

Markdown pages point agents to llms.txt

llms.txt directive found in markdown of 10 of 11 sampled pages (1 missing); 4 had no markdown version

llms.txt exists

llms.txt found at 2 locations; using https://www.mintlify.com/docs/llms.txt as canonical

llms.txt follows the standard structure

llms.txt follows the proposed structure (H1, blockquote, heading-delimited link sections)

llms.txt fits in an agent's context

llms.txt is 23,260 characters (under 50,000 threshold)

llms.txt links work

All 15 same-origin sampled links resolve (88 total links)

llms.txt links point to Markdown

15/15 same-origin sampled links point to markdown content (100%)

Pages are available as Markdown

11/11 sampled pages support .md URLs (100%)

Server returns Markdown when asked

10/11 sampled pages support content negotiation (91%); 1 returned error pages

Content is in the HTML without JavaScript

All 15 sampled pages contain server-rendered content

Markdown pages fit in context

All 11 pages under 50K chars (median 6K, max 41K)

HTML pages fit in context

All 15 sampled pages under 50K chars (median 225K HTML → 15K markdown (70% boilerplate))

Content starts near the top

Content starts within first 10% on all 15 sampled pages (median 1%)

Headings inside tabs name their variant

1 page(s) with tabs found, but no section headers inside tab panels to evaluate

Tabs don't bloat the page

1 tab group(s) across 1 of 15 sampled pages; all serialize under 50K chars

Code blocks are well-formed

All 12 code fences properly closed across 13 pages

Missing pages return a real 404

All 15 sampled pages return proper error codes for bad URLs

Redirects stay on the same host

All 1 redirect(s) across 15 sampled pages are same-host HTTP redirects

llms.txt covers the whole site

llms.txt covers 80/264 sitemap doc pages (30%); 184 missing; 35 llms.txt links not in sitemap (may indicate stale links or incomplete sitemap)

Markdown matches the HTML page

All 10 pages have equivalent markdown and HTML content (avg 1% missing); 1 failed to fetch

Cache headers allow timely updates

All 17 endpoints have appropriate cache headers

Gated docs offer another way in

All docs pages are publicly accessible; no alternative access paths needed

Docs are readable without logging in

All 15 sampled pages are publicly accessible

Sitemap lists the docs pages

The sitemap at https://www.mintlify.com/sitemap.xml lists 102 of the 114 docs pages found through llms.txt and page links.

Crawlers and AI assistants may read the docs

robots.txt lets Googlebot, Bingbot, OAI-SearchBot, PerplexityBot, Claude-SearchBot and Claude-User read the docs.

Pages say when they were last changed

10 of 10 sampled pages state when they were last changed.

Links and section anchors work

All 36 links and 15 section anchors checked on the sampled pages work. 2 more could not be verified (timeouts or blocked requests) and are not counted.

Sitemap entries still exist

All 10 sitemap entries sampled still exist.

Endpoints in the docs exist in the API spec

4 of 4 endpoints mentioned in the docs are not in https://www.mintlify.com/docs/openapi.json.

Deprecated operations are marked as such

https://www.mintlify.com/docs/openapi.json marks no operation as deprecated, so there is nothing to compare.