Upgrade

llms.txt exists

llms.txt found at 2 locations; using https://developer.upgrade.com/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 9,974 characters (under 50,000 threshold)

llms.txt links work

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

llms.txt links point to Markdown

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

Pages point agents to llms.txt

llms.txt directive found in HTML of all 15 sampled pages, near the top of content

Markdown pages point agents to llms.txt

llms.txt directive found in markdown of all 15 sampled pages, near the top of content

Server returns Markdown when asked

Content negotiation partially supported: 0 correct type, 15 wrong type, 0 HTML only

Pages are available as Markdown

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

HTML pages fit in context

1 of 15 sampled pages convert to over 100K chars (max 795K HTML → 122K markdown (98% boilerplate))

Content is in the HTML without JavaScript

All 15 sampled pages contain server-rendered content

Markdown pages fit in context

All 15 pages under 50K chars (median 4K, max 14K)

Content starts near the top

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

Tabs don't bloat the page

No tabbed content detected across 15 sampled pages

Headings inside tabs name their variant

No tabbed content found; header quality check not applicable

Code blocks are well-formed

All 24 code fences properly closed across 17 pages

Missing pages return a real 404

All 15 sampled pages return proper error codes for bad URLs

Redirects stay on the same host

No redirects detected across 15 sampled pages

Markdown matches the HTML page

1 of 15 pages have substantive content differences between markdown and HTML (avg 5% missing)

llms.txt covers the whole site

llms.txt covers 68/74 sitemap doc pages (92%); 6 missing; 34 llms.txt links not in sitemap (may indicate stale links or incomplete sitemap)

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://developer.upgrade.com/sitemap_index.xml lists 73 of the 116 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

0 of 15 sampled pages state when they were last changed, and 9 more have a date only in the sitemap.

Links and section anchors work

1 of 19 references checked on the sampled pages are broken: 0 links and 1 section anchor.

Sitemap entries still exist

All 10 sitemap entries sampled still exist.

Endpoints in the docs exist in the API spec

No OpenAPI description was found, so the docs could not be compared with a spec.

Deprecated operations are marked as such

No OpenAPI description was found, so deprecation notices could not be compared with a spec.