Rebuild the docs using Astro

[andij]

Outcome

The Nucleus documentation rendered with Astro and Starlight.

Scope

• [x] Evaluate the existing Nucleus documentation and understand what's required
• [ ] Rebuild the docs specific components as required
  • colours.js
  • component-placement.js
  • page-footer.js
  • storybook-page.js
  • storybook-story.js
• [ ] Identify additional components that can help
• [ ] Code freeze on Nucleus Docs to perform the migration
• [ ] Refactor all documents
• [ ] Update README

[andij]

I have evaluated the process of re-platforming our docs to Astro and Starlight.

Here is the epic branch: https://github.com/centrica-engineering/nucleus-docs/tree/epic/replatform-astro

It's proven to be straightforward and requires a few 'find and replace' tasks across all documents. For example:

• Update the frontmatter 'title'
• Relocate the images to src/assets
• Remove .md from any docs links
• Move the imports to frontmatter

[PtitBen]

Astro has been set up. An Epic for the new docs has been created