responsive images stable

[sarah11918]

Description (required)

Un-experimentalizes responsive images!

Moves the responsive image docs (properties, guide, reference, explanations) to the proper locations throughout the stable docs.

In particular:

• the component properties are moved to the astro:assets module page
• the configuration reference properties are no longer named using experimental
• the Images guide is updated to describe how the image components (and with configuration, images written with Markdown image syntax) behave when given responsive image properties
• deletes the existing experimental reference page

Additionally, with the addition of new image content, the Image Guide itself has been slightly reorganized and lightly edited with some overall improvements:

• colocating the "Images in X filetype" sections, since the available image options depend firstly on the type of file in which you want to add an image
• adding a new **Options:** list at the start of each of these sections so that at a glance, it is easy to tell which image methods are available in that file type
• creating a new <h2> to group all the "components" (<Image />, <Picture />, SVGs as components, creating a custom component (e.g. <BlogPostImage /> ) for easy reuse of images that share default settings), and removing this content from within the "Images in .astro files" section
  • Note: Originally, this grouping was to emphasize that these are Astro components, for use within .astro files. This draft instead optimizes for quickly identifying your image options based on the file type, but no longer provides all that content within that section. This allows readers to quickly see and compare how different file types work, and find the details later on the page in a dedicated section for components.
• Updating some section headings:
  • the Image and Picture headings were too long and trying to convey too much information in the section heading
  • in fact, the Picture section heading was now "incorrect" as it was previously described as "for producing responsive images" but now we have a responsive image feature that applies to both image and picture components
  • "Setting default values" was originally worded based on having received questions about whether defaults can be set for the components. Previously, the answer was now. Now, it's "no, except for configured responsive images." Now, the section heading focuses on the solution presented: creating custom components when you want/need consistent, reusable image attributes and styles. This also is in keeping with the section now being focused on "components"
• improvements and bug fixes

Related issues & labels (optional)

• Closes #
• Suggested label:

For Astro version: 5.x. See astro PR #. // will fill in when known

[netlify]

✅ Deploy Preview for astro-docs-2 ready!

Name	Link
🔨 Latest commit	f7d41a1
🔍 Latest deploy log	https://app.netlify.com/projects/astro-docs-2/deploys/682f7f7f35806f000822a26f
😎 Deploy Preview	https://deploy-preview-11741--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/guides/images.mdx	Source changed, localizations will be marked as outdated.
en/reference/configuration-reference.mdx	Source changed, localizations will be marked as outdated.
en/reference/experimental-flags/responsive-images.mdx	Source changed, localizations will be marked as outdated.
en/reference/modules/astro-assets.mdx	Source changed, localizations will be marked as outdated.

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.