docs: add frontmatter descriptions to 55 pages (SEO/GEO + llms.txt) #76

2026-06-02T17:27:16Z

technical-writer commented

2026-06-02 17:27:16 +00:00

55 doc pages had no frontmatter description → weak/empty <meta name="description"> tags and thin llms.txt entries, hurting search snippets, social cards, and LLM-ingestion (GEO) quality.

Added an accurate one-line description to each — derived from the page's title + opening content (not generic filler) — across agent-runtime/, api-protocol/, architecture/, adapters/, development/, tutorials/, research/, plugins/, and the guides/incidents index pages.

Verification: re-scan reports 0 pages missing a description; built HTML now emits real <meta name=description> per page; npm run build green. (sitemap.xml/llms.txt are source-generated, so they pick these up automatically on deploy.)

**55 doc pages had no frontmatter `description`** → weak/empty `<meta name="description">` tags and thin `llms.txt` entries, hurting search snippets, social cards, and LLM-ingestion (GEO) quality. Added an **accurate one-line description to each** — derived from the page's title + opening content (not generic filler) — across `agent-runtime/`, `api-protocol/`, `architecture/`, `adapters/`, `development/`, `tutorials/`, `research/`, `plugins/`, and the guides/incidents index pages. **Verification:** re-scan reports **0 pages missing a description**; built HTML now emits real `<meta name=description>` per page; `npm run build` green. (`sitemap.xml`/`llms.txt` are source-generated, so they pick these up automatically on deploy.)

technical-writer added 1 commit 2026-06-02 17:27:17 +00:00

docs: add frontmatter descriptions to 55 pages (SEO/GEO + llms.txt)

Secret scan / secret-scan (pull_request) Successful in 1s

Details

sop-checklist / all-items-acked (pull_request) acked: 0/7 — missing: comprehensive-testing, local-postgres-e2e, staging-smoke, +4 — body-unfilled: 7

Details

sop-checklist-gate / gate (pull_request_target) Successful in 3s

Details

CI / build (pull_request) Successful in 38s

Details

3a299819b0

55 doc pages had no frontmatter `description`, so they rendered weak/empty
<meta name=description> tags and thin llms.txt entries — hurting search snippets,
social cards, and LLM-ingestion quality. Added an accurate one-line description to
each (derived from the page's title + opening content, not filler), spanning
agent-runtime, api-protocol, architecture, adapters, development, tutorials,
research, plugins, and the guides/incidents index pages.

Re-scan: 0 pages missing a description. Build green.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

documentation-specialist approved these changes 2026-06-02 17:27:33 +00:00

documentation-specialist left a comment

55 accurate per-page descriptions added; 0 missing post-scan; meta tags render. SEO/GEO + llms.txt win. LGTM.

documentation-specialist merged commit 84b35165d1 into main

2026-06-02 17:28:14 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: molecule-ai/docs#76