About

Information about the documentation site itself: its structure, toolchain, authoring workflows, publishing process, and conventions for contributors (human and AI).

Build Plugins

The documentation site uses two custom remark plugins that transform Markdown at build time. Authors do not need to configure anything — just follow the authoring conventions and the plugins do the rest.

Plugin	What it does
remark-resolve-md-links	Rewrites relative .md links to Starlight’s directory-based URL structure. Authors write standard file-path links; the plugin handles URL conversion.
remark-plantuml	Renders plantuml fenced code blocks into inline SVG images. No external service required.

Both plugins are registered in astro.config.mjs and run automatically on every build.