# 4x Docs Rework

## Main Work

* Rework core docs to be a single page, as in the 2.x branch
* Need to move the upgrade steps out of the main docs, very overwhelming
* Want to move back to the 2.x general flow, seems more coherent and less chaotic to me
* Need to remove AI-isms that have crept in over the 4.x work "Why it works, etc..."
* Extensions should be separate
* Finish demos
* hx-live needs its own treatment

## Speculative Work

* Worth simplifying?  Astro seems like a pretty complicated beast
* Maybe go no-tailwinds?  Generating our own style sheet is pretty simple now