3rd-party media hosting category updates

src/content/docs/en/guides/images.mdx

@@ -11,10 +11,12 @@ import ReadMore from '~/components/ReadMore.astro';
 
 Astro provides several ways for you to use images on your site, whether they are stored locally inside your project, linked to from an external URL, or managed in a CMS or CDN.
 
-Astro provides [image](#image-) and [picture](#picture-) components, [Markdown image syntax](#images-in-markdown-files) processing, [SVG components](#svg-components), and [an image generating function](#generating-images-with-getimage) to optimize and/or transform your images. Additionally, you can configure [automatically resizing responsive images](#responsive-image-behavior) by default, or set responsive properties on individual image and picture components.
+Astro provides built-in [`<Image />`](#image-) and [`<Picture />`](#picture-) Astro components, [Markdown image syntax](#images-in-markdown-files) (`![]()`) processing, [SVG components](#svg-components), and [an image generating function](#generating-images-with-getimage) to optimize and/or transform your images. Additionally, you can configure [automatically resizing responsive images](#responsive-image-behavior) by default, or set responsive properties on individual image and picture components.
 
 You can always choose to use images and SVG files using native HTML elements in `.astro` or Markdown files, or the standard way for your file type (e.g. `<img />` in MDX and JSX). However, Astro does not perform any processing or optimization of these images.
 
+There is also no native video support in Astro, and we recommend choosing a [hosted video service](/en/guides/media/) to handle the demands of optimizing and streaming video content.
+
 <ReadMore>See the full API reference for the [`<Image />`](/en/reference/modules/astro-assets/#image-) and [`<Picture />`](/en/reference/modules/astro-assets/#picture-) components.</ReadMore>
 
 ## Where to store images

src/content/docs/en/guides/imports.mdx

@@ -134,17 +134,23 @@ CSS Modules help you enforce component scoping & isolation on the frontend with
 ### Other Assets
 
 ```jsx
+// Returns an object with `src` and other properties
 import imgReference from './image.png'; // imgReference === '/src/image.png'
 import svgReference from './image.svg'; // svgReference === '/src/image.svg'
 import txtReference from './words.txt'; // txtReference === '/src/words.txt'
 
-// This example uses JSX, but you can use import references with any framework.
+// HTML or UI Framework components use this to render the image
 <img src={imgReference.src} alt="image description" />;
+
+// The Astro `<Image />` and `<Picture />` components access `src` by default
+<Image src={imgReference} alt="image description">
 ```
 
-All other assets not explicitly mentioned above can be imported via ESM `import` and will return a URL reference to the final built asset. This can be useful for referencing non-JS assets by URL, like creating an image element with a `src` attribute pointing to that image.
+All other assets not explicitly mentioned above can be imported via ESM `import` and will return a URL reference to the final built asset (e.g. `/_astro/my-video.C7vXpQtF.mp4`) instead of an object.
+
+This can be useful for referencing non-JS assets by URL, like creating a video element with a `src` attribute pointing to that image.
 
-It can also be useful to place images in the `public/` folder as explained on the [project-structure page](/en/basics/project-structure/#public).
+It can also be useful to place images and other assets in the `public/` folder as explained on the [project-structure page](/en/basics/project-structure/#public).
 
 <ReadMore>Read more about appending Vite import parameters (e.g. `?url`, `?raw`) in [Vite's static asset handling guide](https://vite.dev/guide/assets.html).</ReadMore>
 

src/content/docs/en/guides/media/index.mdx

@@ -1,41 +1,36 @@
 ---
-title: Use a DAM with Astro
-description: How to use a Digital Asset Manager (DAM) to add images and videos to Astro
+title: Image and video hosting with Astro
+description: How to use a hosted media service to add images and videos to Astro
 sidebar:
-  label: Digital Asset Management overview
+  label: Media hosting overview
 i18nReady: true
 ---
 import MediaGuidesNav from '~/components/MediaGuidesNav.astro';
 import ReadMore from '~/components/ReadMore.astro';
 import Badge from "~/components/Badge.astro"
 
-**Ready to connect a headless Digital Asset Manager (DAM) to your Astro project?** Follow one of our guides to integrate a hosted media system.
-
-:::tip
-Find [community-maintained integrations](https://astro.build/integrations/) for connecting a DAM or hosted media system to your project in our integrations directory. 
-:::
+Follow one of our guides to integrate images and videos from a hosted media service.
 
 ## Hosted Media Guides
 
-Note that many of these pages are **stubs**: they're collections of resources waiting for your contribution!
-
 <MediaGuidesNav />
 
-## Why use a DAM or hosted media?
+## Why use hosted media?
 
-Using a DAM, or Digital Asset Manager, helps individuals, teams, and organizations manage their image and video assets from a central location much like a [CMS](/en/guides/cms/).
+Hosted media helps individuals, teams, and organizations store, manage, optimize, and deliver their image and video assets with dedicated APIs from a central location.
 
-The difference is the type of content being managed: a DAM would primarily manage images, videos, other media assets like 3D models, and any metadata associated with those assets.
+This centralization can be useful, particularly when using a single source of truth for your assets between multiple web or mobile properties. This is important if you're part of an organization that requires multiple teams to use the same assets, or are integrating into other content systems like a PIM (Product Information Manager) to connect your assets to products.
 
-This can be useful particularly when using a single source of truth for your assets between multiple web or mobile properties. This is important if you're part of an organization that requires multiple teams to use the same assets, or are integrating into other content systems like a PIM (Product Information Manager) to connect your assets to products.
+Image hosting services can transform and optimize your images, automatically delivering optimized versions for your visitors. These [remote images](/en/guides/images/#remote-images) can be used in Astro's built-in `<Image />` and `<Picture />` components, and are available to all file types in your project, including Markdown, MDX, and UI Framework components.
 
-## Which hosted media systems or DAMs work well with Astro?
+Video hosting services like [Mux](/en/guides/media/mux/) can provide performant on-demand and live-streaming video delivery along with customizable video players, giving significant reliability and scaling benefits over handling local content. They will handle video transcoding, compression, and transformation to provide a smooth user experience. A platform like Mux may also include data analysis to help you understand your user engagement.
 
-Much like when using a CMS, as Astro handles the _presentation_ of your content, you'll want to use a headless DAM that allows you to fetch and interact with your assets via an API or SDK.
+## Which hosted media systems work well with Astro?
 
-Some headless DAMs, like Cloudinary, provide an Astro [integration](/en/guides/integrations-guide/) that allows you to easily fetch your assets as well as display them on your website or app.
+Much like when using a CMS, you'll want to use hosted services that allow you to fetch and interact with your assets via an API or SDK. Some services may additionally include Astro-native components for displaying your images or videos.
 
-## Can I use Astro without a hosted media system or DAM?
+## Can I use Astro without a hosted media system?
 
 Yes! Astro provides built-in ways to [store images](/en/guides/images/#where-to-store-images), including support for referencing remote images.
 
+However, there is no native video support in Astro, and we recommend choosing a service like [Mux](/en/guides/media/mux/) to handle the demands of optimizing and streaming video content.