feat: add experimetal svgo docs

[azat-io]

Description (required)

Adds documentation for the new experimental SVG optimization feature.

Related to: withastro/astro#13880

• Added new page at /reference/experimental-flags/svg/
• Includes configuration examples and common use cases
• Documents SVGO integration and error handling

Related issues & labels (optional)

N/A.

[netlify]

✅ Deploy Preview for astro-docs-2 ready!

Built without sensitive environment variables

Name	Link
🔨 Latest commit	553426a
🔍 Latest deploy log	https://app.netlify.com/projects/astro-docs-2/deploys/690ce08fcb7b91000835ced1
😎 Deploy Preview	https://deploy-preview-12637--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 project configuration.

[astrobot-houston]

Lunaria Status Overview

🌕 This pull request will trigger status changes.

Learn more

By default, every PR changing files present in the Lunaria configuration's files property will be considered and trigger status changes accordingly.

You can change this by adding one of the keywords present in the ignoreKeywords property in your Lunaria configuration file in the PR's title (ignoring all files) or by including a tracker directive in the merged commit's description.

Tracked Files

File	Note
en/reference/experimental-flags/svg-optimization.mdx	Localization added, will be marked as complete.

Warnings reference

Icon	Description
🔄️	The source for this localization has been updated since the creation of this pull request, make sure all changes in the source have been applied.

[sarah11918]

Thanks for this docs PR @azat-io ! It's wonderfully well-written and a pleasure to read!

I made some initial comments/thoughts here, because I still want some questions answered in the other PR first before we look at this one too closely. Just want to make sure we're clear on the feature before we hit the docs too hard, but it's now a work in progress! 🙌

[sarah11918]

Thanks for the further clarifications and updates!

I've left already a handful of comments below for some reworking of the page here for your consideration.

Also, given that this works only for SVG components, in general, let's use the term "SVG component imports" instead of "SVG imports." This avoids the question of whether this does anything for SVG's not used specifically as components. (For example, people might wonder about using this with UI framework components, but the SVG component pattern is only for Astro components.)

I know below is a lot, so I'm going to stop now and let you look over it all! 😄

[azat-io]

1. Restructured document: moved Usage before Configuration
2. Updated terminology: "SVG assets" → "SVG components" with link to guide
3. Enhanced Usage section: added error handling info, noted no per-component opt-out
4. Added svgoConfig documentation: plugins subsection and other options subsection
5. Updated SVGO link: from preset-default to general plugins page
6. Enhanced "Common use cases": added intro paragraph, replaced removeHiddenElems with removeMetadata
7. Simplified "Further reading": removed redundant links

[sarah11918]

This looks fantastic @azat-io , thank you! Just one broken link here, as mentioned, but then I think this is great!

[sarah11918]

LGTM! Thank you for all your work and responsiveness getting these docs done, @azat-io ! Assuming nothing about this feature changes, these docs will be ready to merge when 5.16.0 is released! 🥳

[sarah11918]

@yanthomasdev - feel free to review at any time!

[ArmandPhilippot]

Thanks, that looks useful! LGTM, I only left two nits (wrong highlighted line and a link that seems a bit odd to me).