Docs-as-code in 2026

As of: 2026-07

The practices

• MDX + repo colocation — docs live in the monorepo, reviewed in PRs with the code they describe; frameworks (Next.js/Starlight/Docusaurus-class) render from the repo.
• Snippets are tested — code samples import from actual source files or run in CI (doctest-style); untested docs samples are the #1 docs rot vector.
• AI-first structure — most "reads" are now agents: clean headings, frontmatter with lastVerified dates, one fact per paragraph, explicit version applicability. The CodexGuild KB schema (asOfDate + appliesFromVersion) is this pattern.
• llms.txt — the emerging convention: a curated markdown index of a site's docs for LLM consumption.

Checks worth adding to CI

1. Docs build (dead links, broken imports).
2. Sample-code compile/run.
3. Freshness: pages with lastVerified older than N months flagged in a report — staleness becomes visible instead of silent.