-
Notifications
You must be signed in to change notification settings - Fork 5
Open
Labels
type:enhancementIssues concerning code or feature improvement (performance, refactoring, etc)Issues concerning code or feature improvement (performance, refactoring, etc)type:tech-debtthe issue is a tech debt that needs fixingthe issue is a tech debt that needs fixing
Description
Background
Currently, our documentation site is built on an older version of Astro and Starlight, approximately ~18 months outdated. This recent PR (#48) updates dependencies to the latest version that does not introduce breaking changes, but further upgrades are blocked by compatibility issues.
The following key issues were encountered moving further up:
- Astro V5 required for higher Starlight versions
- Dynamic sidebar menu loading no longer functioning as expected
- Custom template conflicting with Astro V5 changes
Goal
Evaluate the feasibility and effort required to migrate the docs platform to the latest Astro and Starlight versions.
If the required effort proves too large or unstable, we should consider abandoning the current setup entirely and rebuild the docs using Starlight's latest default templates, focusing on migrating the content with minimal design overhead.
Metadata
Metadata
Assignees
Labels
type:enhancementIssues concerning code or feature improvement (performance, refactoring, etc)Issues concerning code or feature improvement (performance, refactoring, etc)type:tech-debtthe issue is a tech debt that needs fixingthe issue is a tech debt that needs fixing