Starlight Docs Platform

This note records the Astro/Starlight docs-platform strategy for voiage.

Baseline decision

• Starlight is the authoritative docs-site platform
• The platform plan should pin a specific Starlight version family and record upgrade steps explicitly
• The default search path should stay on Pagefind unless a later decision justifies a different provider

Required plugins

• starlight-versions — versioned docs pages and release-aligned navigation
• starlight-links-validator — broken-link validation in the docs site

Conditional plugins

These are useful if the eventual Starlight site needs the corresponding UX:

• starlight-image-zoom
• starlight-heading-badges
• starlight-sidebar-topics
• starlight-utils

Content boundary

The Astro/Starlight site must preserve:

• the current docs content hierarchy
• version-aware navigation
• link validation
• docs build and content smoke checks

The platform decision is complete; future work should evolve the site without introducing a second documentation build system.