Concepts
Understand the static site, repository data, and agent interfaces.
Static by design
Fumadocs MDX compiles source content into React pages. Next.js enumerates documentation routes at build time. The host only serves files. Browser-side project filters and Pagefind search do not need a server.
Repository-led content
data/repositories.json records the committed public repository capture;
data/repository-audit.json preserves the historical upstream audit.
The curated records in data/projects/ select projects, categories, homepage
features, and editorial overrides. Build-time generation combines them with
repository facts to produce the project directory, documentation, and navigation.
A description sourced from the current snapshot carries its capture date; a
legacy attribution is identified separately. Descriptions state repository
scope, not verified maturity. See the documentation policy
for the editing workflow.
data/packages.json supplies the package page. Builds do not call the GitHub
API or registries.
The intended live worker-client integration and snapshot fallback depend on unfinished M2 and M3 work. The current site is snapshot-only.
Human and agent access
The same canonical sources produce HTML and portable Markdown. See AI access for the generated indexes.