Merge branch 'v3-upgrade-guide' into i18n-ja-view-transition-v3

src/content/docs/en/getting-started.mdx

@@ -8,9 +8,9 @@ import TranslatorList from '~/components/TranslatorList.astro'
 import ContributorList from '~/components/ContributorList.astro'
 import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
 
-{/* TODO: Replace with 3.0 tip on 30 August 2023. */}
-:::tip[Hello Astronauts!]
-Our new docs theme [Starlight is on Product Hunt today](https://www.producthunt.com/posts/starlight-by-astro).
+:::tip[Astro version 3 is here!]
+**What’s new in Astro v3?** [Find out in the announcement blog post](https://astro.build/blog/astro-3/).  
+**Ready to upgrade?** [Follow our upgrade guide](/en/guides/upgrade-to/v3/).
 :::
 
 <h2>What is Astro?</h2>

src/content/docs/es/core-concepts/astro-components.mdx

@@ -334,7 +334,7 @@ Astro soporta importar y usar archivos `.html` como componentes o colocarlos den
 Los componentes HTML solo deben contener HTML válido, y por lo tanto le faltarán características claves de los componentes de Astro.
 - Ellos no soportan el frontmatter, importaciones del lado del servidor, o expresiones dinámicas.
 - Cualquier etiqueta `<script>` quedan sin agrupar, son tratados como si tuvieran `in:inline`
-- Ellos solo pueden referenciar recursos que están en la carpeta [`public/`](/es/guides/images/#public).
+- Ellos solo pueden referenciar recursos que están en la carpeta [`public/`](/es/core-concepts/project-structure/#public).
 
 :::note
 Un [elemento `<slot/>`](/es/core-concepts/astro-components/#slots) dentro de un componente HTML trabajar como lo haría en un componente de Astro. En cambio, para poder usar el elemento [Componente Web HTML Slot](https://developer.mozilla.org/es/docs/Web/HTML/Element/slot) añade `is:inline` al elemento `slot`.

src/content/docs/es/guides/integrations-guide/vercel.mdx

@@ -209,9 +209,11 @@ export default defineConfig({
 });
 ```
 
-### Funciones por página
+### Configuración de agrupación de funciones
 
-El adaptador de Vercel se construye en una sola función de forma predeterminada. Astro 2.7 agregó soporte para dividir tu compilación en puntos de entrada separados por página. Si usas esta configuración, el adaptador de Vercel generará una función separada para cada página. Esto puede ayudar a reducir el tamaño de cada función para que solo estén empaquetando el código utilizado en esa página.
+El adaptador de Vercel divide las compilaciones en una función separada por ruta de forma predeterminada. Esto ayuda a reducir el tamaño de cada función, ya que solo agrupa el código utilizado en esa página.
+
+Puedes desactivar esto y compilar en una única función configurando la opción de configuración `functionPerRoute` en `false`:
 
 ```js
 // astro.config.mjs
@@ -221,7 +223,7 @@ import vercel from '@astrojs/vercel/serverless';
 export default defineConfig({
   output: 'server',
   adapter: vercel({
-    functionPerRoute: true,
+    functionPerRoute: false,
   }),
 });
 ```

src/content/docs/es/guides/migrate-to-astro/from-gatsby.mdx

@@ -87,8 +87,6 @@ Puede resultarte útil instalar algunas de las [integraciones opcionales de Astr
 
 - **@astrojs/react**: para reutilizar algunos componentes UI de React existentes en tu nuevo sitio Astro o seguir escribiendo con componentes de React.
 
-- **@astrojs/image**: para reemplazar el complemento de imagen de Gatsby con los propios componentes de optimización de imagen de Astro. (Experimental: funciona solo en archivos `.astro` y `.mdx`)
-
 - **@astrojs/mdx**: para llevar los archivos MDX existentes de tu proyecto de Gatsby o utilizar MDX en tu nuevo sitio Astro.
 
 
@@ -321,36 +319,28 @@ Ver más sobre [Estilizando en Astro](/es/guides/styling/).
 
 ### Plugin de imágenes de Gatsby a Astro
 
-:::note
-Astro v3.0 incluirá un nuevo módulo `astro:assets` y descontinuará la integración existente `@astrojs/image`.
-
-Accede a `astro:assets` actualmente está disponible bajo una flag experimental, y es la forma recomendada de comenzar un nuevo proyecto de Astro. Si estás migrando a Astro pre-v3.0, recomendamos [habilitar la flag experimental para usar assets](/es/guides/assets/) como solución de imagen.
-:::
-
-Convierte los componentes `<StaticImage />` y `<GatsbyImage />` de Gatsby con la [integración de imágenes de Astro](/es/guides/images/#integración-image-de-astro), o utiliza una etiqueta HTML `<img>` / JSX `<img />` estándar según corresponda.
+Convierte los componentes `<StaticImage />` y `<GatsbyImage />` de Gatsby a [los propios componentes de integración de imágenes de Astro](/es/guides/images/#image--astroassets), o a una etiqueta [estándar de HTML `<img>` / JSX `<img />`](/es/guides/images/#imágenes-en-componentes-de-frameworks-ui) según corresponda en tus componentes de React.
 
 ```astro title="src/pages/index.astro"
 ---
-import { Image } from '@astrojs/image/components';
-import localImage from "../images/brand/logo.png";
-import rocket from '../images/rocket.svg';
+import { Image } from 'astro:assets';
+import rocket from '../assets/rocket.png';
 ---
-<Image src={localImage} alt="The Astro Logo" />
-<img src={rocket} alt="A rocketship in space.">
+<Image src={rocket} alt="Un cohete en el espacio." />
+<img src={rocket.src} alt="Un cohete en el espacio.">
 ```
 
-Los componentes `<Image />` y `<Picture />` de Astro son experimentales y actualmente solo funcionan en archivos `.astro` y `.mdx` files only. Puedes ver una [lista completa de atributos de componente](/es/guides/integrations-guide/image/#uso) disponibles para estos componentes, y debes tener en cuenta que varios atributos difieren de los atributos de Gatsby.
+El componente `<Image />` de Astro funciona solo en archivos `.astro` y `.mdx`. Consulta una [lista completa de sus atributos de componente](/es/guides/images/#propiedades) y ten en cuenta que varios serán diferentes de los atributos de Gatsby.
 
-Para continuar utilizando imágenes locales en archivos Markdown (`.md`) utilizando la sintaxis estándar de Markdown (`![]()`),mueve tus imágenes a la carpeta `public/`. Es posible que debas actualizar el enlace a la URL relativa. También puedes utilizar la etiqueta `<img>` estándar en estos archivos. Ten en cuenta que estas [imágenes en `public/` no serán optimizadas por Astro](/es/guides/images/#public).
+Para seguir utilizando [imágenes en archivos Markdown (`.md`)](/es/guides/images/#imágenes-en-archivos-markdown) utilizando la sintaxis estándar de Markdown (`![]()`), es posible que necesites actualizar el enlace. El uso de la etiqueta HTML `<img>` no es compatible en archivos `.md` para imágenes locales, y debe ser convertido a la sintaxis de Markdown.
 
 ```md
 <!-- src/pages/post-1.md -->
 
 # Mi página Markdown
 
-<!-- Imagen local almacenada en public/assets/stars.png -->
-![Un cielo estrellado en la noche.](/assets/stars.png)
-<img src="/assets/stars.png" alt="Un cielo estrellado en la noche.">
+<!-- Imagen local almacenada en src/assets/stars.png -->
+![Un cielo estrellado en la noche.](../assets/stars.png)
 ```
 
 En componentes de React (`.jsx`), utiliza la sintaxis estándar de JSX para imágenes (`<img />`). Astro no optimizará estas imágenes, pero puedes instalar y utilizar paquetes de NPM para obtener más flexibilidad.

src/content/docs/es/guides/migrate-to-astro/from-nextjs.mdx

@@ -83,9 +83,6 @@ Puede resultarte útil instalar algunas de las [integraciones opcionales de Astr
 
 - **@astrojs/react**: Para reutilizar algunos de los componentes UI de React existentes en tu nuevo sitio de Astro, o seguir escribiendo con componentes de React.
 
-- **@astrojs/image**: 
-para reemplazar el plugin Image de Next con los propios componentes de optimización de imágenes de Astro. (Experimental: solo funciona en archivos `.astro` y `.mdx`)
-
 - **@astrojs/mdx**: Para traer archivos MDX existentes de tu proyecto Next, o para usar MDX en tu nuevo sitio Astro.
 
 ### Coloca tu código fuente en `src`
@@ -420,22 +417,17 @@ Ver más acerca de [Estilos en Astro](/es/guides/styling/).
 
 ### Plugin de Imagen de Next a Astro
 
-:::note
-Astro v3.0 incluirá un nuevo módulo `astro:assets` y descontinuará la integración existente `@astrojs/image`.
-
-Accede a `astro:assets` actualmente está disponible bajo una flag experimental, y es la forma recomendada de comenzar un nuevo proyecto de Astro. Si estás migrando a Astro pre-v3.0, recomendamos [habilitar la flag experimental para usar assets](/es/guides/assets/) como solución de imagen.
-:::
+Convierte cualquier componente `<Image />` de Next a [el componente de imagen propio de Astro](/es/guides/images/#image--astroassets) en archivos `.astro` o `.mdx`, o a una etiqueta [estándar de HTML `<img>` / JSX `<img />`](/es/guides/images/#imágenes-en-componentes-de-frameworks-ui) según corresponda en tus componentes de React.
 
-Convierte cualquier componente `<Image />` de Next a los [propios componentes de integración de imagen de Astro](/es/guides/images/#integración-image-de-astro), o a un estándar HTML `<img>`. Consulta [la lista completa de los atributos de los componentes](/es/guides/integrations-guide/image/#uso) disponibles para los componentes `<Image />` y `<Picture />` de Astro, y ten en cuenta que varios difieren de los atributos de Next. 
+El componente `<Image />` de Astro funciona solo en archivos `.astro` y `.mdx`. Consulta una [lista completa de sus atributos de componente](/es/guides/images/#propiedades) y ten en cuenta que varios serán diferentes de los atributos de Next.
 
 ```astro title="src/pages/index.astro"
 ---
-import { Image } from '@astrojs/image/components';
-import localImage from "../images/brand/logo.png";
-import rocket from '../images/rocket.svg';
+import { Image } from 'astro:assets';
+import rocket from '../assets/rocket.png';
 ---
-<Image src={localImage} alt="The Astro Logo" />
-<img src={rocket} alt="A rocketship in space.">
+<Image src={rocket} alt="Un cohete en el espacio." />
+<img src={rocket.src} alt="Un cohete en el espacio.">
 ```
 
 En los componentes de React (`.jsx`), utiliza la sintaxis estándar de imagen (`<img />`). Astro no optimizará estas imágenes, pero puedes instalar y usar paquetes de NPM  para obtener más flexibilidad.

src/content/docs/es/guides/migrate-to-astro/from-nuxtjs.mdx

@@ -106,8 +106,6 @@ Puede resultarte útil instalar algunas de las [integraciones opcionales de Astr
 
 - **@astrojs/vue**: para reutilizar algunos componentes de interfaz de usuario Vue existentes en tu nuevo sitio Astro, o seguir escribiendo con componentes Vue.
 
-- **@astrojs/image**: para reemplazar el plugin de imagen de Nuxt con los propios componentes de optimización de imagen de Astro.
-
 - **@astrojs/mdx**: para traer archivos MDX existentes de tu proyecto Nuxt, o para usar MDX en tu nuevo sitio Astro.
 
 ### Coloca tu código fuente en `src`
@@ -513,24 +511,17 @@ Ve más sobre [Estilos en Astro](/es/guides/styling/).
 
 ### Plugin de imagen de Nuxt a Astro
 
-:::note
-Astro v3.0 incluirá un nuevo módulo `astro:assets` y descontinuará la integración existente `@astrojs/image`.
-
-Accede a `astro:assets` actualmente está disponible bajo una flag experimental, y es la forma recomendada de comenzar un nuevo proyecto de Astro. Si estás migrando a Astro pre-v3.0, recomendamos [habilitar la flag experimental para usar assets](/es/guides/assets/) como solución de imagen.
-:::
-
-Convierte cualquier [componente `<nuxt-img/>` o `<nuxt-picture/>` de Nuxt](https://image.nuxtjs.org/components/nuxt-img) a [la integración de imagen de Astro](/es/guides/images/#integración-image-de-astro) o a una etiqueta HTML `<img>` estándar.
+Convierte cualquier [componente `<nuxt-img/>` or `<nuxt-picture/>` de Nuxt](https://image.nuxtjs.org/components/nuxt-img) al [componente de imagen propio de Astro](/es/guides/images/#image--astroassets) en archivos `.astro` o `.mdx`, o al tag estándar [`<img>`](/es/guides/images/#imágenes-en-componentes-de-frameworks-ui) o `<picture>` de HTML según corresponda en tus componentes de Vue.
 
-Mira una [lista completa de atributos de componentes](/es/guides/integrations-guide/image/#uso) disponibles para los componentes `<Image />` y `<Picture />` de Astro, y ten en cuenta que varios serán diferentes a los atributos de Nuxt.
+El componente `<Image />` de Astro funciona solo en archivos `.astro` y `.mdx`. Consulta una [lista completa de sus atributos de componente](/es/guides/images/#propiedades) y ten en cuenta que varios serán diferentes de los atributos de Nuxt.
 
 ```astro title="src/pages/index.astro"
 ---
-import { Image } from '@astrojs/image/components';
-import localImage from "../images/brand/logo.png";
-import rocket from '../images/rocket.svg';
+import { Image } from 'astro:assets';
+import rocket from '../assets/rocket.png';
 ---
-<Image src={localImage} alt="The Astro Logo" />
-<img src={rocket} alt="A rocketship in space.">
+<Image src={rocket} alt="Un cohete en el espacio." />
+<img src={rocket.src} alt="Un cohete en el espacio.">
 ```
 
 En los componentes Vue (`.vue`) dentro de tu aplicación Astro, usa la sintaxis de imagen JSX estándar (`<img />`). Astro no optimizará estas imágenes, pero puedes instalar y usar paquetes NPM para tener más flexibilidad.