withastro · yanthomasdev · Aug 30, 2023 · Jul 11, 2023 · Jul 12, 2023 · Jul 13, 2023
diff --git a/netlify.toml b/netlify.toml
@@ -83,6 +83,14 @@
     from = "/:lang/guides/client-side-routing"
     to = "/:lang/guides/view-transitions"
 
+  [[redirects]]
+    from = "/:lang/guides/assets"
+    to = "/:lang/guides/images"
+
+  [[redirects]]
+    from = "/:lang/guides/integrations-guide/image"
+    to = "/:lang/guides/images"
+
   [[redirects]]
     from = "/:lang/migration/0.21.0"
     to = "/:lang/guides/upgrade-to/v1"

diff --git a/src/content/docs/de/guides/images.mdx → old-translations/de/guides/images.mdx b/src/content/docs/de/guides/images.mdx → old-translations/de/guides/images.mdx
@@ -9,7 +9,7 @@ import Since from '~/components/Since.astro';
 Astro bietet dir verschiedene Möglichkeiten, Bilder auf deiner Website zu verwenden, ganz gleich, ob sie lokal in deinem Projekt gespeichert sind, auf anderen Quellen verlinkt werden oder in einem CMS oder CDN gespeichert sind!
 
 :::note[Assets verwenden (Experimentell)]
-Die experimentelle Asset-Unterstützung wurde in `[email protected]` hinzugefügt. Wenn du die Unterstützung für Assets aktiviert hast, findest du weitere Informationen in der [Asset-Anleitung (Experimentell)](/de/guides/assets/).
+Die experimentelle Asset-Unterstützung wurde in `[email protected]` hinzugefügt. Wenn du die Unterstützung für Assets aktiviert hast, findest du weitere Informationen in der [Asset-Anleitung (Experimentell)](/de/guides/images/).
 
 **Einige der folgenden Ratschläge sind nicht mit der experimentellen Flag kompatibel.**
 :::
@@ -38,7 +38,7 @@ import rocket from '../images/rocket.svg';
 
 Du kannst die Standard Markdown `![]()` Syntax oder die Standard HTML `<img>`-Tags in deinen `.md`-Dateien für Bilder verwenden, die sich in deinem `public/`-Ordner befinden, oder für Remote-Bilder auf einem anderen Server.
 
-Wenn du deine Bilder nicht in `public/` speichern kannst, empfehlen wir, die [experimentelle Unterstützung für Assets](/de/guides/assets/) zu aktivieren oder das Dateiformat `.mdx` zu verwenden, mit dem du importierte Komponenten mit einer Markdown-ähnlichen Syntax kombinieren kannst. Verwende die [MDX-Integration](/de/guides/integrations-guide/mdx/), um Astro-Unterstützung für MDX hinzuzufügen.
+Wenn du deine Bilder nicht in `public/` speichern kannst, empfehlen wir, die [experimentelle Unterstützung für Assets](/de/guides/images/) zu aktivieren oder das Dateiformat `.mdx` zu verwenden, mit dem du importierte Komponenten mit einer Markdown-ähnlichen Syntax kombinieren kannst. Verwende die [MDX-Integration](/de/guides/integrations-guide/mdx/), um Astro-Unterstützung für MDX hinzuzufügen.
 
 ```md
 <!-- src/pages/post-1.md -->
@@ -121,7 +121,7 @@ Das Attribut `src` ist **relativ zum öffentlichen Ordner**. In Markdown kannst
 
 ### `src/assets/` (experimentell)
 
-In der Anleitung [Assets (Experimentell)](/de/guides/assets/) kannst du nachlesen, wie du den Ordner `/assets/` experimentell nutzen kannst.
+In der Anleitung [Assets (Experimentell)](/de/guides/images/) kannst du nachlesen, wie du den Ordner `/assets/` experimentell nutzen kannst.
 
 Dazu musst du deine bestehenden Bilder aktualisieren, die aktuelle Astro-Bildintegration entfernen und zusätzliche manuelle Änderungen vornehmen, um einige der neuen Funktionen zu nutzen.
 
@@ -132,7 +132,7 @@ Die offizielle Bild-Integration von Astro bietet zwei verschiedene Astro-Kompone
 Nach der [Installation von `@astrojs/image`](/de/guides/integrations-guide/image/#installation) kannst du diese beiden Komponenten überall dort verwenden, wo du Astro-Komponenten verwenden kannst: in `.astro`- und `.mdx`-Dateien.
 
 :::note[Inkompatibel mit Assets]
-Wenn du die experimentelle Asset-Unterstützung aktiviert hast, musst du die offizielle Integration deinstallieren. Weitere Informationen findest du im [Assets (Experimental) Guide](/de/guides/assets/).
+Wenn du die experimentelle Asset-Unterstützung aktiviert hast, musst du die offizielle Integration deinstallieren. Weitere Informationen findest du im [Assets (Experimental) Guide](/de/guides/images/).
 :::
 
 ### `<Image />`

diff --git a/src/content/docs/es/guides/images.mdx → old-translations/es/guides/images.mdx b/src/content/docs/es/guides/images.mdx → old-translations/es/guides/images.mdx
@@ -12,7 +12,7 @@ import Since from '~/components/Since.astro';
 :::note[`astro:assets` (Experimental - en camino para la versión v3.0)]
 El modulo experimental `astro:assets` estará habilitado por defecto en `[email protected]`.
 
-¡Sigue la [Guía de Assets (Experimental)](/es/guides/assets/) para comenzar a usar la nueva solución de imágenes de Astro hoy mismo!
+¡Sigue la [Guía de Assets (Experimental)](/es/guides/images/) para comenzar a usar la nueva solución de imágenes de Astro hoy mismo!
 
 **Algunos de los consejos a continuación son incompatibles con la bandera experimental. Consulta la página de Assets si estás usando `astro:assets`.**
 :::
@@ -129,7 +129,7 @@ La integración [`@astrojs/image`](https://github.com/withastro/astro/tree/main/
 
 Te sugerimos que la elimines lo antes posible y que uses el módulo experimental `astro:assets` que se integrará en `[email protected]`.
 
-¡Sigue la [Guía de Assets (experimental)](/es/guides/assets/) para empezar a usar la nueva solución de imágenes de Astro hoy mismo!
+¡Sigue la [Guía de Assets (experimental)](/es/guides/images/) para empezar a usar la nueva solución de imágenes de Astro hoy mismo!
 
 **`astro:assets` no es un reemplazo completo de `@astrojs/image` en este momento, pero está en desarrollo activo.**
 :::

diff --git a/src/content/docs/fr/guides/images.mdx → old-translations/fr/images.mdx b/src/content/docs/fr/guides/images.mdx → old-translations/fr/images.mdx
diff --git a/src/content/docs/ja/guides/images.mdx → old-translations/ja/images.mdx b/src/content/docs/ja/guides/images.mdx → old-translations/ja/images.mdx
@@ -8,7 +8,7 @@ import Since from '~/components/Since.astro';
 Astroは、プロジェクト内に保存されている画像やリモート上にリンクされている画像、CMSやCDNに保存されている画像をサイト上で表示するために様々な手段を提供しています。
 
 :::note[アセットの活用 (実験的)]
-実験的なアセットサポートが`[email protected]`に追加されました。アセットサポートを有効にした場合、追加情報については [アセット (実験的) ガイド](/ja/guides/assets/) を参照してください。
+実験的なアセットサポートが`[email protected]`に追加されました。アセットサポートを有効にした場合、追加情報については [アセット (実験的) ガイド](/ja/guides/images/) を参照してください。
 
 **以下のアドバイスの中には、アセットのフラグを有効にした場合に互換性がなくなるものもあります。**
 :::
@@ -38,7 +38,7 @@ import rocket from '../images/rocket.svg';
 
 `.md`ファイル内では標準的な`![]()`構文や`<img>`タグを記載することで`public/`フォルダや、他サーバー上にあるリモート画像を表示できます。
 
-もし`public/`に画像を保存できない場合、[アセットの実験的なサポート](/ja/guides/assets/)を有効にするか、インポートされたコンポーネントをMarkdownのような構文と組み合わせて使える`.mdx`ファイルフォーマットを利用することをお勧めします。AstroにMDXのサポートを追加するには[MDX インテグレーション](/ja/guides/integrations-guide/mdx/)を利用します。
+もし`public/`に画像を保存できない場合、[アセットの実験的なサポート](/ja/guides/images/)を有効にするか、インポートされたコンポーネントをMarkdownのような構文と組み合わせて使える`.mdx`ファイルフォーマットを利用することをお勧めします。AstroにMDXのサポートを追加するには[MDX インテグレーション](/ja/guides/integrations-guide/mdx/)を利用します。
 
 ```md
 <!-- src/pages/post-1.md -->
@@ -120,7 +120,7 @@ import logo from '../images/logo.png';
 
 ### `src/assets/` (実験的)
 
-`/assets/` フォルダの実験的な使用を有効にするには、[アセット(実験的)](/ja/guides/assets/)ガイドを参照してください。
+`/assets/` フォルダの実験的な使用を有効にするには、[アセット(実験的)](/ja/guides/images/)ガイドを参照してください。
 
 その場合、既存の画像を更新し、現在のAstro画像インテグレーションを削除する必要があります。また、Astroの新機能の一部を利用するためには、さらに手動での変更が必要になります。
 
@@ -131,7 +131,7 @@ Astro公式の画像のインテグレーションは、最適化された画像
 [`@astrojs/image`のインストール](/ja/guides/integrations-guide/image/#installation)で、`.astro`と`.mdx`などのAstroコンポーネントを利用できるファイル内でこの2つのコンポーネントを利用できます。
 
 :::note[アセットの互換性がない]
-アセットの実験的なサポートを有効にしている場合は、公式インテグレーションをアンインストールする必要があります。詳細については、[アセット (実験的) ガイド](/ja/guides/assets/) を参照してください。
+アセットの実験的なサポートを有効にしている場合は、公式インテグレーションをアンインストールする必要があります。詳細については、[アセット (実験的) ガイド](/ja/guides/images/) を参照してください。
 :::
 
 ### `<Image />`

diff --git a/src/content/docs/pt-br/guides/images.mdx → old-translations/pt-br/guides/images.mdx b/src/content/docs/pt-br/guides/images.mdx → old-translations/pt-br/guides/images.mdx
@@ -11,7 +11,7 @@ Astro providencia diversas formas de você utilizar imagens em seu site, estejam
 :::note[`astro:assets` (Experimental - chegando em v3.0)]
 O módulo experimental `astro:assets` vai ser habilitado por padrão em `[email protected]`.
 
-Siga o [Guia de Assets (Experimental)](/pt-br/guides/assets/) para começar a usar a nova solução de imagens do Astro hoje mesmo!
+Siga o [Guia de Assets (Experimental)](/pt-br/guides/images/) para começar a usar a nova solução de imagens do Astro hoje mesmo!
 
 **Algumas das recomendações abaixo são incompatíveis com a flag experimental. Por favor veja a página de Assets se você estiver usando `astro:assets`.**
 :::
@@ -40,7 +40,7 @@ import foguete from '../imagens/foguete.svg';
 
 Você pode utilizar a sintaxe `![]()` padrão do Markdown ou tags `<img>` padrão do HTML em seus arquivos `.md` para imagens localizadas no seu diretório `public/` ou imagens remotas em outro servidor.
 
-Se você não consegue manter suas imagens em `public/`, nós recomendamos habilitar o [suporte experimental para assets](/pt-br/guides/assets/), ou utilizar o formato de arquivo `.mdx`, que permite que você combine componentes importados com sintaxe estilo Markdown. Use a [integração MDX](/pt-br/guides/integrations-guide/mdx/) para adicionar suporte a MDX no Astro.
+Se você não consegue manter suas imagens em `public/`, nós recomendamos habilitar o [suporte experimental para assets](/pt-br/guides/images/), ou utilizar o formato de arquivo `.mdx`, que permite que você combine componentes importados com sintaxe estilo Markdown. Use a [integração MDX](/pt-br/guides/integrations-guide/mdx/) para adicionar suporte a MDX no Astro.
 
 ```md
 <!-- src/pages/postagem-1.md -->
@@ -123,7 +123,7 @@ O atributo `src` é **relativo ao diretório public**. No Markdown, você pode t
 
 ### `src/assets/` (experimental)
 
-Veja o guia [Assets (Experimental)](/pt-br/guides/assets/) para habilitar o uso experimental da pasta `/assets/`.
+Veja o guia [Assets (Experimental)](/pt-br/guides/images/) para habilitar o uso experimental da pasta `/assets/`.
 
 Isso vai exigir que você atualize suas imagens existentes, remover a atual integração Image do Astro, e também vai exigir mudanças manuais adicionais para explorar as vantagens de algumas de suas funcionalidades.
 
@@ -134,7 +134,7 @@ A integração [`@astrojs/image`](https://github.com/withastro/astro/tree/main/p
 
 Nós sugerimos remover ela assim que for conveniente e utilizar o módulo experimental `astro:assets` que fará parte do `[email protected]`.
 
-Siga o [Guia de Assets (Experimental)](/pt-br/guides/assets/) para começar a usar a nova solução de imagens do Astro hoje mesmo!
+Siga o [Guia de Assets (Experimental)](/pt-br/guides/images/) para começar a usar a nova solução de imagens do Astro hoje mesmo!
 
 **`astro:assets` não é um substituto completo do `@astrojs/image` nesse momento, mas está sob constante desenvolvimento.**
 :::

diff --git a/src/content/docs/zh-cn/guides/images.mdx → old-translations/zh-CN/guides/images.mdx b/src/content/docs/zh-cn/guides/images.mdx → old-translations/zh-CN/guides/images.mdx
@@ -11,7 +11,7 @@ import Since from '~/components/Since.astro';
 :::note[`astro:assets` (Experimental - coming in v3.0)]
 实验性 `astro:assets` 模块将在 `[email protected]` 中默认启用.
 
-请按照 [资源（实验性）使用指南](/zh-cn/guides/assets/) 开始使用新的图片解决方案！
+请按照 [资源（实验性）使用指南](/zh-cn/guides/images/) 开始使用新的图片解决方案！
 
 **下面的一些建议可能与实验性标志不兼容。如果你正在使用 `astro:assets` 请参考资源页面。**
 :::
@@ -41,7 +41,7 @@ import rocket from '../images/rocket.svg';
 
 可以在 `.md` 文件中使用 Markdown 标准语法 `![]()`，或 HTML 标准语法 `<img>` 标签，来调用位于 `public/` 文件夹下或其它服务器上的图片。
 
-如果你无法将图片保留在 `public/` 中，我们建议启用 [资源的实验性支持](/zh-cn/guides/assets/), 或使用 `.mdx` 文件格式，该格式允许你将导入的组件与类似 Markdown 的语法结合起来。使用 [MDX 集成](/zh-cn/guides/integrations-guide/mdx/) 向 Astro 添加对 MDX 的支持。
+如果你无法将图片保留在 `public/` 中，我们建议启用 [资源的实验性支持](/zh-cn/guides/images/), 或使用 `.mdx` 文件格式，该格式允许你将导入的组件与类似 Markdown 的语法结合起来。使用 [MDX 集成](/zh-cn/guides/integrations-guide/mdx/) 向 Astro 添加对 MDX 的支持。
 ```md
 <!-- src/pages/post-1.md -->
 
@@ -126,7 +126,7 @@ import logo from '../images/logo.png';
 
 ### `src/assets/` （实验性）
 
-请参阅 [资源（实验性）](/zh-cn/guides/assets/) 指南，了解如何启用 `/assets/` 文件夹的实验性用法。
+请参阅 [资源（实验性）](/zh-cn/guides/images/) 指南，了解如何启用 `/assets/` 文件夹的实验性用法。
 
 这将需要你更新现有图片，删除当前的 Astro 图片集成，并且还需要额外的手动更改以利用其某些新功能。
 
@@ -137,7 +137,7 @@ Astro v3 将不再主动支持 [`@astrojs/image`](https://github.com/withastro/a
 
 我们建议你尽早删除它，并使用将内置在 `[email protected]` 中的实验性 `astro:assets` 模块。
 
-请按照 [资源（实验性）使用指南](/zh-cn/guides/assets/) 开始使用新的图片解决方案！
+请按照 [资源（实验性）使用指南](/zh-cn/guides/images/) 开始使用新的图片解决方案！
 
 **`astro:assets` 目前还不能完全替代 `@astrojs/image` ，但它正在被积极开发中。**
 :::
@@ -160,4 +160,4 @@ Image CDN 可与 Astro 配合使用，可将图片的完整网址作为 `<img>`
 
 ## 社区开发的集成
 
-除了官方的 [`@astrojs/image`](/zh-cn/guides/integrations-guide/image/) 集成外，社区还开发了[社区图片集成](https://astro.build/integrations?search=images)，用于处理和优化 Astro 项目中的图片。
+除了官方的 [`@astrojs/image`](/zh-cn/guides/integrations-guid/image/) 集成外，社区还开发了[社区图片集成](https://astro.build/integrations?search=images)，用于处理和优化 Astro 项目中的图片。
diff --git a/src/content/docs/ar/core-concepts/astro-components.mdx b/src/content/docs/ar/core-concepts/astro-components.mdx
@@ -286,7 +286,7 @@ const { title } = Astro.props
 
 - لا يدعمون frontmatter، أو الإستيراد على جانب الخادم (Server-side imports)، أو التعابير الديناميكية.
 - أي وسوم `<script>` تُركت غير مجمّعة، سيتم التعامل معها كما لو انها تحتوي على `is:inline`.
-- يمكنهم فقط [إسناد الموارد الموجودة في مجلد `public/`](/ar/guides/images/#public) 
+- يمكنهم فقط [إسناد الموارد الموجودة في مجلد `public/`](/ar/core-concepts/project-structure/#public) 
 
 :::note
 [عنصر `<slot />`](/ar/core-concepts/astro-components/#المداخل) الموجود داخل مكوّن HTML سيعمل كما يعمل في مكوّن أسترو. لإستخدام عنصر ["HTML Web Component Slot"](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/slot) بدلًا من ذلك، أضف  `is:inline` إلى عنصر `<slot />` الخاص بك.

diff --git a/src/content/docs/en/core-concepts/astro-components.mdx b/src/content/docs/en/core-concepts/astro-components.mdx
@@ -342,7 +342,7 @@ Astro supports importing and using `.html` files as components or placing these
 HTML components must contain only valid HTML, and therefore lack key Astro component features:
 - They don't support frontmatter, server-side imports, or dynamic expressions.
 - Any `<script>` tags are left unbundled, treated as if they had `is:inline`. 
-- They can only [reference assets that are in the `public/` folder](/en/guides/images/#public).
+- They can only [reference assets that are in the `public/` folder](/en/core-concepts/project-structure/#public).
 
 :::note
 A [`<slot />` element](/en/core-concepts/astro-components/#slots) inside an HTML component will work as it would in an Astro component. In order to use the [HTML Web Component Slot](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/slot) element instead, add `is:inline` to your `<slot>` element.

diff --git a/src/content/docs/en/core-concepts/project-structure.mdx b/src/content/docs/en/core-concepts/project-structure.mdx
@@ -66,9 +66,6 @@ Some files (like Astro components) are not even sent to the browser as written b
 While this guide describes some popular conventions used in the Astro community, the only directories reserved by Astro are `src/pages/` and `src/content/`. You are free to rename and reorganize any other directories in a way that works best for you.
 :::
 
-### `src/assets`
-
-The [`src/assets`](/en/guides/assets/) directory is the recommended folder to use for storing assets (e.g. images) that are processed by Astro. This is not required, and this is not a special reserved folder.
 
 ### `src/components`