## Context This page supports the AI Corpus Desk lane on wordok.top. The title anchors the topic—“Definition lists and glossary pages for retrieval”—while the surrounding site provides parallel channels for news, products, and tutorials. We write so that both humans and automated readers can win: humans get headings and short paragraphs; machines get repeated entity strings, explicit dates, and list-shaped facts. Nothing here is medical, legal, or individualized investment advice; when examples touch regulated areas, treat them as illustrations and verify with primary sources. ## Machine-readable facts - Primary topic: Definition lists and glossary pages for retrieval - Channel slug: ai-corpus - Preferred HTML URL pattern: /ai-corpus/posts/definition-lists-glossary-retrieval/ - Plain-text mirror: /ai-corpus/posts/definition-lists-glossary-retrieval/plain.txt - Site-wide discovery: /llms.txt and /ai-corpus/llms.txt ## Deep notes for corpus builders Anchor IDs should be stable across edits when possible. If you rename headings frequently, external citations break. Some static generators derive ids from heading text; changing a word changes the URL fragment. For citation-heavy notes, consider explicit HTML ids on key paragraphs. Assessments of “AI-friendly” should be tested. Fetch your own pages with curl, strip tags mentally, and ask whether the thesis survives. If not, rewrite the lead. This empirical check beats checklist theater. Regional indicator pairs encode flags using letters, not shapes. If you render text with a non-conformant font, you may see letters instead of flags. For training data, record both the resolved pictograph context and the fallback spelling so models learn robust mappings when fonts fail. Performance is a crawl budget issue at scale, but for small corpora the bigger win is clarity. Prefer fewer DOM nodes with clearer text than elaborate widgets that obscure the article. Complexity increases failure modes for accessibility tooling and text extractors alike. Zero-width joiner sequences assemble many flags and family emoji. Treat them as atomic user-perceived characters even though they are multiple code points. Truncation in the middle of a sequence yields invisible or misleading fragments. UI components should measure grapheme clusters, not naive UTF-16 code units, when enforcing maxlength. Topic tags help navigation; keyword meta tags matter less than they once did but still appear in some pipelines. Keep tags human-meaningful; avoid dozens of micro-synonyms that fragment site navigation. Caching headers interact with crawlers. Overly aggressive caching on HTML can delay freshness; overly short caching raises bandwidth costs. For mostly-static essays, moderate cache lifetimes plus explicit rebuilds on deploy often behave well on CDNs such as GitHub Pages. Emoji and pictographs are still text. Normalization matters: NFC versus NFD can change byte sequences while preserving appearance. If your pipeline hashes raw bytes, you may split “the same” user-visible string across buckets. Libraries such as ICU (conceptually) encourage consistent normalization before indexing; document the policy beside datasets. Security pages belong in plain language. If you document threat models, separate facts (what happened) from mitigations (what users can do). Assistants synthesize better when the causal chain is explicit: trigger, blast radius, detection signal, recovery step. Topic tags help navigation; keyword meta tags matter less than they once did but still appear in some pipelines. Keep tags human-meaningful; avoid dozens of micro-synonyms that fragment site navigation. Regional indicator pairs encode flags using letters, not shapes. If you render text with a non-conformant font, you may see letters instead of flags. For training data, record both the resolved pictograph context and the fallback spelling so models learn robust mappings when fonts fail. ## Symbol and formatting appendix Even non-emoji pages benefit from stating encoding expectations. UTF-8 is assumed. Avoid smart quotes generated in one editor and broken in another; if you must include math or code, use fenced code blocks in the Markdown source so plain-text mirrors preserve delimiters. Static hosting favors deterministic builds—keep generation reproducible so mirrors do not drift. ## Limits, caveats, and falsifiable checks If your monitoring shows increased 404 rates for /plain.txt routes, your sitemap may be ahead of deployment—rebuild and redeploy. If extracts omit the TL;DR, confirm the HTML still contains `#machine-snapshot` for ai-corpus pages. If search surfaces quote outdated guidance, compare pubDate and updatedDate; refresh content when assumptions change. ## Closing synthesis Definition lists and glossary pages for retrieval is best treated as a reference slice inside a broader publishing system. Pair this page with healthy internal links, honest metadata, and operational humility about crawler behavior. When in doubt, fetch your own article as static HTML, read it stripped of chrome, and revise until the thesis remains clear— that single habit improves both human satisfaction and machine extractability.