Skip to content

Add agent-readable docs discovery - #39

Merged
yashau merged 1 commit into
mainfrom
codex/docs-agent-discovery
Aug 4, 2026
Merged

Add agent-readable docs discovery#39
yashau merged 1 commit into
mainfrom
codex/docs-agent-discovery

Conversation

@yashau

@yashau yashau commented Aug 4, 2026

Copy link
Copy Markdown
Owner

Summary

  • publish llms.txt, compact/full variants, and source-aligned Markdown for every public docs page
  • serve Markdown from canonical docs URLs through content negotiation while keeping static assets asset-first
  • add robots.txt and verify robots, sitemap, LLM indexes, and per-page Markdown during the docs build
  • document release verification for the new agent-facing endpoints

The Worker implementation is compatible with the site's current Cloudflare Free plan; it does not depend on the paid native Markdown for Agents feature.

Validation

  • mise run node:check
  • mise run node:lint
  • mise run node:format-check
  • mise run docs:lint
  • mise run docs:build
  • pnpm --dir apps/docs exec tsc -p worker/tsconfig.json --noEmit
  • pnpm --dir apps/docs exec wrangler deploy --dry-run
  • local Wrangler HTTP smoke covering HTML/Markdown negotiation, q-values, HEAD, robots, sitemap, and LLM indexes

@yashau
yashau marked this pull request as ready for review August 4, 2026 18:29
@yashau
yashau merged commit a8e6bc3 into main Aug 4, 2026
1 check passed
@yashau
yashau deleted the codex/docs-agent-discovery branch August 4, 2026 18:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant