Migrate website to astro

[timotheeguerin]

After some quick investigation migrating to astro would both improve build performance and runtime performance.

Astro main selling point is everything is rendered on the server(unless go through extra step to have dynamic content) This means it result in a completely static website without the need for javascript. Somethings like light/dark theme switch still use js but the core of the website is available.

Pros:

• Build perf 2:30min(docusaurus) -> 50s(astro) - tested on m1 pro
  • EDIT: build perf is actually very bad when the sidebar is included
• Use tm grammar for syntax highlighting (no more prismjs with half baked syntax highlighting)

Issues:

• [ ] Doesn't support multiple sidebar or versioning which make migration today impossible without a lot of manual work. There are some active issues for those problem and it seems to be getting traction.
• [x] Auto generated sidebar doesn't have good names for folders. This could be mitigated by having our own custom resolver

- [x] Initial side by side migration https://github.com/microsoft/typespec/pull/4587
- [x] Migrate more react component to astro https://github.com/microsoft/typespec/pull/4710
- [x] Add blog https://github.com/microsoft/typespec/pull/4797
- [x] Header responsive https://github.com/microsoft/typespec/pull/4800
- [x] astro prettier plugin
- [x] Switch which version gets published
- [ ] Remove docusaurus
- [ ] Move docs/ folder? https://github.com/microsoft/typespec/pull/4928

[rishi-raj-jain]

I'd love to be part of this effort.

[timotheeguerin]

@rishi-raj-jain thanks for your intrest, I did go through this a while ago but there was some deal breaking issues https://github.com/microsoft/typespec/pull/2562

1. Actually terrible perf when including the sidebar ( i believe this has been fixed since)
2. Doesn't support multi versions

So I don't think this is something we can do right now

[rishi-raj-jain]

Doesn't support multi versions

Why's that the case? I believe you can use https://starlight.astro.build and just create folders for versioning, ain't it?

[timotheeguerin]

Yeah we can just need to then do the selection ourself. The first item was the biggest deal breaker the version might just need more or less work from us