Linserin Yang's Notes

llms.txt follows the standard structure

llms.txt contains parseable links but doesn't fully follow the proposed structure: https://notes.linserin.work/llms.txt: No blockquote summary found

llms.txt exists

llms.txt found at https://notes.linserin.work/llms.txt

llms.txt fits in an agent's context

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

llms.txt links work

All 4 same-origin links resolve (4 total links)

llms.txt links point to Markdown

4/4 same-origin 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

Server ignores Accept: text/markdown header (0/15 sampled pages return markdown)

Pages are available as Markdown

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

Content starts near the top

4 of 15 sampled pages have content starting past 50% (worst 100%)

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 1K, max 5K)

HTML pages fit in context

All 15 sampled pages under 50K chars (median 96K HTML → 7K markdown (93% boilerplate))

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

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

Code blocks are well-formed

All 66 code fences properly closed across 16 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

3 of 15 pages have minor content differences between markdown and HTML

llms.txt covers the whole site

llms.txt covers 98% of 46 sitemap doc pages

Cache headers allow timely updates

All 16 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

Crawlers and AI assistants may read the docs

robots.txt lets Googlebot, Bingbot, OAI-SearchBot, PerplexityBot, Claude-SearchBot and Claude-User read the docs. Also blocked: GPTBot, ClaudeBot, Google-Extended and CCBot (training crawlers; opting out of training is a policy choice, not scored).

Sitemap lists the docs pages

The sitemap at https://notes.linserin.work/sitemap-index.xml lists 17 of the 17 docs pages found through llms.txt and page links.

Pages say when they were last changed

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

Links and section anchors work

All 10 links and 4 section anchors checked on the sampled pages work. 1 more could not be verified (timeouts or blocked requests) and is not counted.

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.