# csenshi.github.io/pg_grpc

[csenshi.github.io/pg_grpc](https://csenshi.github.io/pg_grpc)

- **Overall score:** 84/100 (Grade B)
- **Checks passed:** 18 / 29
- **Last computed:** 2026-05-11

## Components

### Content Discoverability

- **Score:** 82/100 · **Status:** partial
- **Summary:** 2 warnings across 6 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 1 location(s)
- ✅ **LLMS TXT Valid** — llms.txt follows the proposed structure (H1, blockquote, heading-delimited link sections)
- ✅ **LLMS TXT Size** — llms.txt is 1,497 characters (under 50,000 threshold)
- ✅ **LLMS TXT Links Resolve** — All 8 same-origin links resolve (8 total links)
- ⚠️ **LLMS TXT Links Markdown** — Same-origin links point to HTML, but 8 have .md variants available Some links in your llms.txt point to HTML pages instead of markdown. Where possible, update links to use .md URLs so agents get clean markdown content directly.
- ⚠️ **LLMS TXT Directive** — llms.txt directive found in 9 of 10 pages, but buried deep in the page (past 50%) An llms.txt directive was found on 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.

### Markdown Availability

- **Score:** 51/100 · **Status:** fail
- **Summary:** 1 failed and 1 warning across 2 AFDocs checks.
- **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** — 8/10 pages support .md URLs (80%); inconsistent support 0 of 10 pages support .md URLs inconsistently. Ensure all documentation pages serve markdown when .md is appended to the URL.
- ❌ **Content Negotiation** — Server ignores Accept: text/markdown header (0/10 pages return markdown) Your server ignores Accept: text/markdown and returns HTML. Some agents (Claude Code, Cursor, OpenCode) request markdown this way. Configure your server to honor content negotiation.

### Page Size and Truncation Risk

- **Score:** 89/100 · **Status:** fail
- **Summary:** 1 failed across 4 AFDocs checks.
- **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 10 pages contain server-rendered content
- ✅ **Page Size Markdown** — All 8 pages under 50K chars (median 5K, max 8K)
- ✅ **Page Size Html** — All 10 pages convert under 50K chars (median 6K, 79% boilerplate)
- ❌ **Content Start Position** — 2 of 10 pages have content starting past 50% (worst 100%) 2 of 10 pages have content starting past 50% of the converted output. Agents may never see the documentation content. Move or remove inline CSS/JS that precedes the content area.

### Content Structure

- **Score:** 100/100 · **Status:** partial
- **Summary:** 1 skipped 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** — 1 tab group(s) across 1 of 10 pages; all serialize under 50K chars
- ⏭️ **Section Header Quality** — 1 page(s) with tabs found, but no section headers inside tab panels to evaluate
- ✅ **Markdown Code Fence Validity** — All 47 code fences properly closed across 9 pages

### URL Stability and Redirects

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

**Checks**

- ✅ **Http Status Codes** — All 10 pages return proper error codes for bad URLs
- ✅ **Redirect Behavior** — No redirects detected across 10 pages

### Observability and Content Health

- **Score:** 87/100 · **Status:** fail
- **Summary:** 1 failed and 1 warning 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 Freshness** — llms.txt covers 8/10 sitemap doc pages (80%); 2 missing Your llms.txt covers 80-95% of your site's pages. 2 live pages are not represented in the index.
- ❌ **Markdown Content Parity** — 5 of 8 pages have substantive content differences between markdown and HTML (avg 22% missing) 5 pages have substantive content differences between markdown and HTML (avg 22% missing). Agents receiving the markdown version are getting outdated or incomplete content. Regenerate markdown from source or fix the build pipeline.
- ✅ **Cache Header Hygiene** — All 11 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 10 pages are publicly accessible
- ⏭️ **Auth Alternative Access** — All docs pages are publicly accessible; no alternative access paths needed

### Full Content Discoverability

- **Score:** 100/100 · **Status:** pass
- **Summary:** llms-full.txt passes all checks.
- **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 is within the expected range.
- ✅ **LLMS Full Valid** — llms-full.txt has a recognizable markdown structure.
- ✅ **LLMS Full Links Resolve** — llms-full.txt has no same-origin links to validate.

### 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 a legacy skill.md file.

### MCP Server

- **Score:** 0/100 · **Status:** fail
- **Summary:** MCP has 1 failing check.
- **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** — No MCP server was discovered at the expected endpoints.
- ⏭️ **MCP Tool Count** — Skipped because the MCP server was not discoverable.