# Arize AI

> [llms.txt](https://www.mintlify.com/llms.txt)

[arize.com/docs/ax](https://arize.com/docs/ax)

- **Overall score:** 97/100 (Grade A)
- **Checks passed:** 24 / 30
- **Last computed:** 2026-08-25

## Components

### Content Discoverability

- **Score:** 99/100 · **Status:** partial
- **Summary:** 1 warning across 7 AFDocs checks.
- **Rationale:** Agents need a clear entry point and crawl map before they can reliably discover the right pages.
- **Reference:** [AFDocs reference](https://afdocs.dev)

**Checks**

- ✅ **LLMS TXT Exists** — llms.txt found at 2 locations; using https://arize.com/docs/llms.txt as canonical
- ✅ **LLMS TXT Valid** — llms.txt follows the proposed structure (H1, blockquote, heading-delimited link sections)
- ✅ **LLMS TXT Size** — llms.txt is 45,192 characters (under 50,000 threshold)
- ✅ **LLMS TXT Links Resolve** — All 15 same-origin sampled links resolve (445 total links)
- ✅ **LLMS TXT Links Markdown** — 15/15 same-origin sampled links point to markdown content (100%)
- ⚠️ **LLMS TXT Directive Html** — llms.txt directive found in HTML of 14 of 15 sampled pages (1 missing) An llms.txt directive was found in the HTML of some pages but is missing from others, or is buried deep in the page. Ensure the directive appears near the top of every documentation page.
- ✅ **LLMS TXT Directive MD** — llms.txt directive found in markdown of all 14 sampled pages, near the top of content; 1 had no markdown version

### Markdown Availability

- **Score:** 93/100 · **Status:** pass
- **Summary:** 2 AFDocs checks pass.
- **Rationale:** When markdown is available directly, agents spend less effort stripping presentation markup and guessing structure.
- **Reference:** [AFDocs reference](https://afdocs.dev)

**Checks**

- ✅ **Markdown Url Support** — 14/15 sampled pages support .md URLs (93%)
- ✅ **Content Negotiation** — 14/15 sampled pages support content negotiation (93%)

### Page Size and Truncation Risk

- **Score:** 100/100 · **Status:** pass
- **Summary:** 4 AFDocs checks pass.
- **Rationale:** Large pages and delayed primary content increase truncation risk and make retrieval less reliable.
- **Reference:** [AFDocs reference](https://afdocs.dev)

**Checks**

- ✅ **Rendering Strategy** — All 15 sampled pages contain server-rendered content
- ✅ **Page Size Markdown** — All 14 pages under 50K chars (median 9K, max 26K)
- ✅ **Page Size Html** — All 15 sampled pages under 50K chars (median 439K HTML → 15K markdown (96% boilerplate))
- ✅ **Content Start Position** — Content starts within first 10% on all 15 sampled pages (median 1%)

### Content Structure

- **Score:** 97/100 · **Status:** partial
- **Summary:** 1 warning across 3 AFDocs checks.
- **Rationale:** Predictable sections, valid code fences, and serialized tabs make the content easier for agents to parse correctly.
- **Reference:** [AFDocs reference](https://afdocs.dev)

**Checks**

- ✅ **Tabbed Content Serialization** — 8 tab group(s) across 7 of 15 sampled pages; all serialize under 50K chars
- ⚠️ **Section Header Quality** — 1 of 2 page(s) with tab headers don't distinguish between variants 25-50% of headers in tabbed sections are generic (e.g., repeated "Step 1" across variants). Add variant context to headers (e.g., "Step 1 (Python)") so agents can distinguish sections.
- ✅ **Markdown Code Fence Validity** — All 36 code fences properly closed across 16 pages

### URL Stability and Redirects

- **Score:** 96/100 · **Status:** fail
- **Summary:** 1 failed across 2 AFDocs checks.
- **Rationale:** Stable URLs and sane redirect behavior prevent retrieval drift and broken tool references.
- **Reference:** [AFDocs reference](https://afdocs.dev)

**Checks**

- ❌ **Http Status Codes** — 1 of 15 sampled pages return 200 for non-existent URLs (soft 404) Your site returns 200 for non-existent pages (soft 404). Agents try to extract information from the error page content instead of recognizing the page is missing. Configure your server to return 404 for pages that don't exist.
- ✅ **Redirect Behavior** — All 1 redirect(s) across 15 sampled pages are same-host HTTP redirects

### Observability and Content Health

- **Score:** 84/100 · **Status:** fail
- **Summary:** 1 failed across 3 AFDocs checks.
- **Rationale:** Coverage, parity, and cache behavior determine whether agents can trust the content they retrieve.
- **Reference:** [AFDocs reference](https://afdocs.dev)

**Checks**

- ❌ **LLMS TXT Coverage** — llms.txt covers 316/534 sitemap doc pages (59%); 218 missing Your llms.txt covers 59% of your site's pages (below 80% threshold). 218 live pages are missing from the index. If unintentional, regenerate llms.txt from your sitemap or build pipeline. If intentional, lower the threshold or set it to 0 to make the check informational.
- ✅ **Markdown Content Parity** — All 14 pages have equivalent markdown and HTML content (avg 1% missing)
- ✅ **Cache Header Hygiene** — All 17 endpoints have appropriate cache headers

### Authentication and Access

- **Score:** 100/100 · **Status:** partial
- **Summary:** 1 skipped across 2 AFDocs checks.
- **Rationale:** Agents need either public access or a clear alternative path when documentation is gated behind auth.
- **Reference:** [AFDocs reference](https://afdocs.dev)

**Checks**

- ✅ **Auth Gate Detection** — All 15 sampled pages are publicly accessible
- ⏭️ **Auth Alternative Access** — All docs pages are publicly accessible; no alternative access paths needed

### Full Content Discoverability

- **Score:** 75/100 · **Status:** fail
- **Summary:** llms-full.txt has 1 failing check.
- **Rationale:** A full-document snapshot gives long-context agents a single canonical corpus to ingest without repeated crawling.
- **Reference:** [llms-full.txt guide](https://www.mintlify.com/docs/ai/llmstxt#llms-full-txt)

**Checks**

- ✅ **LLMS Full Exists** — Found llms-full.txt.
- ❌ **LLMS Full Size** — llms-full.txt size falls outside the expected range.
- ✅ **LLMS Full Valid** — llms-full.txt has a recognizable markdown structure.
- ✅ **LLMS Full Links Resolve** — llms-full.txt links resolve successfully.

### Agent Skills

- **Score:** 100/100 · **Status:** pass
- **Summary:** skill.md passes all checks.
- **Rationale:** Agent skills provide product-specific operating guidance that plain documentation pages do not encode on their own.
- **Reference:** [skill.md guide](https://www.mintlify.com/docs/ai/skillmd)

**Checks**

- ✅ **Skill MD** — Found an agent skill definition.

### MCP Server

- **Score:** 100/100 · **Status:** pass
- **Summary:** MCP passes all checks.
- **Rationale:** A discoverable MCP server lets agents use first-class tools instead of scraping pages and inferring behavior.
- **Reference:** [MCP guide](https://www.mintlify.com/docs/ai/model-context-protocol)

**Checks**

- ✅ **MCP Server Discoverable** — Found an MCP server.
- ✅ **MCP Tool Count** — The MCP server exposes tools.