The first thing I would do is stop trying to support AI tools, and remove any comments about AI from the documentation.

Generative AI is not suitable for building content-driven websites because it lacks context to understand subjective user preferences.

Also, having .astro files to implement island functionality is unnecessary. Interactivity can be implemented with Javascript using web components.

Yeah, I agree on the AI front. Although outside of the AI page, I don't believe we have other content on it. It was intentional to keep it separate from the rest of the docs. I know we've recently discussed making changes / removing some of that content.

I love web components (one of the things that got me into Astro), but it can be helpful to reach for something like Solid when you get into more complex UI. Most Astro projects will never need to reach for that, which is why there's no UI framework available by default.

Astro definitely tries to stick to a minimal defaults approach by design. We'd rather people start from a simple, minimal boilerplate, and reach for solutions (e.g. UI frameworks, on-demand rendering) only when they run into a problem it solves.