Skip to content

Feature: Static Site Generator & Documentation Porting #37

@razshare

Description

@razshare

Is your feature request related to a problem? Please describe.

Recently I was updating our docs to include some of the new changes we introduced with v1.45.x, when out of nowhere Astro Starlight just stopped building.

Mind you I hadn't touched the codebase in any shape or form for a couple of weeks at that point.

It was building just fine on my machine, yet it wasn't building in GitHub actions.

Image

In the end I solved the issue, apparentely was Astro's image processing service just stopped working in GitHub actions, without me making any changes to the workflow configuration or the project configurations.

Describe the solution you'd like

I didn't sign up for any of that, we're talking mere static files here, that shouldn't be so convoluted and prone to errors to generate.

In fact we can do that easily, so we should, and after that we should port our documentation to use our own static site generator feature.

Describe alternatives you've considered

MKDocs is a pretty good alternative and it's battle tested. It also has file system lookup in development mode, which Starlight, for some arcane reason, does not unless you actually build the whole thing.

Additional context

Add any other context or screenshots about the feature request here.

Metadata

Metadata

Assignees

Labels

No labels
No labels

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions