Skip to content
Rosetta.md

Home

ROSETTA.MD

Rosetta.md

Section titled “”

An AI-native documentation baseline.

Rosetta.md is an opinionated Astro Starlight baseline for project documentation. Pages are organized into the four Diátaxis categories — tutorials, how-to guides, reference, and explanation — and every page has a raw-markdown twin so agents can consume the docs without scraping HTML. Use this site as the canonical source of truth for how this project is built, used, and extended.

Stack

Section titled “Stack”
  • TypeScript TypeScript — type-safe authoring for the config surface and build-time integrations.
  • Astro Astro — static site generator; pages compile to plain HTML.
  • Docker Docker — containerized build and preview, so docs ship the same way on every machine.

The four kinds of page

Section titled “The four kinds of page”

Every page in this site is exactly one of these. Pick by the reader’s state of mind, not by topic.

TutorialsLearning-oriented. A beginner follows steps from zero to their first working result.How-to guidesProblem-oriented. A competent reader has a named goal and just needs the recipe.ReferenceInformation-oriented. Dry, structured, exhaustive — a map of the machinery.ExplanationUnderstanding-oriented. The why — context, trade-offs, and the shape of the problem.

How the baseline is enforced

Section titled “How the baseline is enforced”
  • Schema-checked frontmatter. A build-time integration rejects any page whose frontmatter doesn’t declare which of the four folders it lives in, so the structure can’t drift as the site grows.
  • The copy as md button. Click the button in any page header to pull the raw-Markdown twin into your clipboard — the fastest way to hand a page to an LLM or paste into an issue.
  • An agent contract. agent-docs-rules.md at the repo root defines how pages are structured so an AI agent can extend the docs without breaking their shape. See Agent & contributor rules.

Next steps

Section titled “Next steps”
Built with rosetta-template