Skip to content
SourceRight

Docs tooling audit

Docs tooling audit

Section titled “Docs tooling audit”

Decision

Section titled “Decision”

This repo owns local documentation through docs-site/, using Astro, Starlight, MDX, and Sitemap.

Commands

Section titled “Commands”
  • docs:dev delegates to docs-site for local preview.
  • docs:build builds the static Astro site.
  • docs:check runs astro check for documentation type/config validation.

Existing sources

Section titled “Existing sources”

Existing Astro docs-site, mdBook/book.toml legacy source, and docs/ Markdown.

CI

Section titled “CI”

.github/workflows/docs.yml installs the docs app dependencies, runs docs:check, and then runs docs:build.

Migration note

Section titled “Migration note”

Legacy generators remain source generators only. Published documentation should converge through this Astro/Starlight app.