Skip to content

Investigate Migration to Astro V5 #61

@HDauven

Description

@HDauven

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

No one assigned

    Labels

    type:enhancementIssues concerning code or feature improvement (performance, refactoring, etc)type:tech-debtthe issue is a tech debt that needs fixing

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions