# Agent-readable pages

Public Markdown and discovery derive from the same content developers read.

## Public representations [#public-representations]

`/llms.txt` lists public content and connection endpoints. `/llms-full.txt` includes the landing, legal text, static demo content and every developer page. Each developer page has a `.md` representation, including `/docs.md`, deep pages and changelog entries.

```sh
curl http://localhost:3005/docs/features/todo-imports.md
curl http://localhost:3005/llms.txt
```

Developer content is English only. Landing/legal Markdown supports `?lang=en`, `?lang=de` and `?lang=fr`. Developer docs URLs enter the sitemap without hreflang alternates. Robots permits docs and excludes authenticated routes.

## Build and rendering [#build-and-rendering]

Fumadocs MDX compiles the repository content and processed Markdown at build time. The headless core supplies the page tree and search. Articles render on the server with shared UI tokens; a public GET route supports browser navigation. Runtime code reads no documentation files from disk and does not evaluate MDX source.

The existing ADR files and `docs/connect-your-agent.md` are imported into the collection, not copied. Relative references become docs links or repository links during compilation. Shiki highlighting happens during the build with github-light/github-dark tokens.

## Extend [#extend]

Add MDX with a title and description under `apps/web/content/docs`, then place it in its folder's `meta.json`. Use ordinary Markdown headings and links. Add a diagram as an accessible static SVG, with its light/dark variants. The source/link tests, sitemap and llms generation pick up the page automatically.

These routes contain only curated public content. Never add private Threads, account data or Organization exports to the public collection. Tool authorization remains the responsibility of the authenticated API.


## Key files [#key-files]

- [`apps/web/source.config.ts`](https://github.com/CarlosZiegler/doro/blob/main/apps/web/source.config.ts)
- [`apps/web/src/lib/docs/source.ts`](https://github.com/CarlosZiegler/doro/blob/main/apps/web/src/lib/docs/source.ts)
- [`apps/web/src/lib/docs/page.server.tsx`](https://github.com/CarlosZiegler/doro/blob/main/apps/web/src/lib/docs/page.server.tsx)
- [`apps/web/src/lib/agent-content.ts`](https://github.com/CarlosZiegler/doro/blob/main/apps/web/src/lib/agent-content.ts)
- [`apps/web/src/routes/sitemap[.]xml.tsx`](https://github.com/CarlosZiegler/doro/blob/main/apps/web/src/routes/sitemap[.]xml.tsx)