Skip to content
- apps/site stays on Astro 6 beta to enable modern marketing experiences.
- apps/docs remains on Astro 5.16.15 with Starlight 0.37.4 until Starlight supports Astro 6.
- pnpm lockfile is authoritative; updates require cross-team coordination.
- Document Every Upgrade — Raise an ADR when bumping major Astro or Starlight versions.
- Respect Divergence — Marketing may adopt new Astro features; docs must trail until compatibility is guaranteed.
- Quarterly Reviews — Platform engineering reviews dependency deltas every quarter and records outcomes in this page.
- Security Patches — Critical security fixes may bypass the quarterly window but require approval from both marketing and security leads.
- Track planned upgrades in project planning tools with links back to this document.
- Run
pnpm install within Docker to refresh the lockfile, then execute pnpm build:site and pnpm build:docs to validate.
- Update ADR-0004 if the compatibility stance changes.
- Successful builds for both applications inside Docker.
- No TypeScript or build warnings introduced by version changes.
- Starlight continues to compile with the intended theme and sidebar.