Server islands

[matthewp]

Description (required)

This includes:

• Updates to the directives reference page.
• Server islands guide
  • Note that this guide could also be a section of the Astro components page. It's longer than any section on that page, however. So it could also be linked to from that page and that's how you get to it.

For Astro version: 5.x.

[netlify]

✅ Deploy Preview for astro-docs-2 ready!

Name	Link
🔨 Latest commit	dc6dde8
🔍 Latest deploy log	https://app.netlify.com/sites/astro-docs-2/deploys/66e32ba73c3af900075b1c29
😎 Deploy Preview	https://deploy-preview-9255--astro-docs-2.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[sarah11918]

Updated comment: After speaking with Fred, I think we do want this on a page in the routing section. So, am starting to redraft a secondary page to see what it would look like with that focus.

[matthewp]

Suggested change

	The most obvious benefit of server islands is the ability to render the more highly dynamic parts of your page on the fly. This allows the outer shell and main content to be more aggressively cached, providing faster performance.
	Server islands is the ability to render the more highly dynamic parts of your page on the fly, leaving the outer shell and main content to be more aggressively cached, providing faster performance.

[sarah11918]

So the push back I'd give here is that we don't really need to redefine server islands at this point. This section is about the benefits, and it should probably start like the client island section does, which is exactly this "The most obvious benefit".

Instead of removing that, if you had to fill in the blank to finish that (or a similar sentence), what would you say?

[yanthomasdev]

Good work, here's a few of my nits/thoughts 🙌