fix broken links

guimachiavelli · guimachiavelli · commit 43488ca2a58c · 2025-04-28T18:59:09.000+02:00
diff --git a/guides/deployment/digitalocean.mdx b/guides/deployment/digitalocean.mdx
@@ -69,7 +69,7 @@ Tags are great for managing resources. They are custom labels you assign to drop
 ### 7. Click on "Create Droplet"
 
 <Frame>
-  <img src="/assets/images/digitalocean/01.create-droplet.png" alt="The 'Create Droplet' button" />
+  <img src="/assets/images/digitalocean/create-droplet.png" alt="The 'Create Droplet' button" />
 </Frame>
 
 ### 8. Test Meilisearch
diff --git a/guides/docker.mdx b/guides/docker.mdx
@@ -81,7 +81,7 @@ The example above uses `$(pwd)/meili_data`, which is a directory in the host mac
 
 ### Generating dumps and updating Meilisearch
 
-To export a dump, [use the create dump endpoint as described in our dumps guide](/learn/advanced/dumps). Once the task is complete, you can access the dump file in `/meili_data/dumps` inside the volume you passed with `-v`.
+To export a dump, [use the create dump endpoint as described in our dumps guide](/learn/data_backup/dumps). Once the task is complete, you can access the dump file in `/meili_data/dumps` inside the volume you passed with `-v`.
 
 To import a dump, use Meilisearch's `--import-dump` command-line option and specify the path to the dump file. Make sure the path points to a volume reachable by Docker:
 
@@ -125,4 +125,4 @@ docker run -it --rm \
   meilisearch --import-snapshot /meili_data/snapshots/data.ms.snapshot
 ```
 
-Use snapshots for backup or when migrating data between two Meilisearch instances of the same version. [Read more about snapshots in our guide.](/learn/advanced/snapshots)
+Use snapshots for backup or when migrating data between two Meilisearch instances of the same version. [Read more about snapshots in our guide.](/learn/data_backup/snapshots)
diff --git a/guides/front_end/search_bar_for_docs.mdx b/guides/front_end/search_bar_for_docs.mdx
@@ -5,9 +5,14 @@ description: Use Meilisearch to index content in a text-heavy website. Covers in
 
 This tutorial will guide you through the steps of building a relevant and powerful search bar for your documentation 🚀
 
-1. [Run a Meilisearch Instance](#run-a-meilisearch-instance)
-2. [Scrape your content](#scrape-your-content)
-3. [Integrate the Search Bar](#integrate-the-search-bar)
+- [Run a Meilisearch instance](#run-a-meilisearch-instance)
+- [Scrape your content](#scrape-your-content)
+  - [Configuration file](#configuration-file)
+  - [Run the scraper](#run-the-scraper)
+- [Integrate the search bar](#integrate-the-search-bar)
+  - [For VuePress documentation sites](#for-vuepress-documentation-sites)
+  - [For all kinds of documentation](#for-all-kinds-of-documentation)
+- [What's next?](#whats-next)
 
 ## Run a Meilisearch instance
 
@@ -205,4 +210,4 @@ For more concrete examples, you can check out this [basic HTML file](https://git
 ## What's next?
 
 At this point, you should have a working search engine on your website, congrats! 🎉
-You can check [this tutorial](/guides/deployment/running_production) if you now want to run Meilisearch in production!
+You can check [this tutorial](/guides/running_production) if you now want to run Meilisearch in production!
diff --git a/guides/laravel_scout.mdx b/guides/laravel_scout.mdx
@@ -70,7 +70,7 @@ For production use cases, we recommend using a managed Meilisearch via [Meilisea
 Read the [Meilisearch Cloud quick start](/learn/getting_started/cloud_quick_start).
 </Tip>
 
-If you prefer to self-host, read our guide for [running Meilisearch in production](/guides/deployment/running_production).
+If you prefer to self-host, read our guide for [running Meilisearch in production](/guides/running_production).
 
 ## Making Eloquent models searchable
 
diff --git a/guides/strapi_v4.mdx b/guides/strapi_v4.mdx
@@ -111,7 +111,7 @@ Now it's time to add your Strapi collection to Meilisearch. In the `Collections`
 By clicking on the checkbox next to `restaurant`, the content-type is automatically indexed in Meilisearch.
 
 <Frame>
-  <img src="/assets/images/strapi-v4/add-collection-to-meilisearch.gif" alt="GIF showing the mouse clicking on 'restaurant' in the Meilisearch collections tab" />
+  <img src="/assets/images/strapi-v4/strapi-add-collection-to-meilisearch.gif" alt="GIF showing the mouse clicking on 'restaurant' in the Meilisearch collections tab" />
 </Frame>
 
 The word “Hooked” appears when you click on the `restaurant`'s checkbox in the `Collections` tab. This means that each time you add, update or delete an entry in your restaurant content-types, Meilisearch is automatically updated.
diff --git a/home.mdx b/home.mdx
@@ -18,7 +18,7 @@ description: Discover our guides, examples, and APIs to build fast and relevant
   </Card>
 </CardGroup>
 
-## Use cases
+## Use case demos
 
 Take at look at example applications built with Meilisearch.
 
diff --git a/learn/ai_powered_search/choose_an_embedder.mdx b/learn/ai_powered_search/choose_an_embedder.mdx
@@ -32,5 +32,5 @@ That said, Hugging Face can be a good embedder for datasets under 10k documents
 <Note>
 Meilisearch Cloud does not support embedders with `{"source": "huggingFace"}`.
 
-To implement Hugging Face embedders in the Cloud, use [HuggingFace inference points with the REST embedder](/guides/ai/huggingface).
+To implement Hugging Face embedders in the Cloud, use [HuggingFace inference points with the REST embedder](/guides/embedders/huggingface).
 </Note>
diff --git a/learn/ai_powered_search/getting_started_with_ai_search.mdx b/learn/ai_powered_search/getting_started_with_ai_search.mdx
@@ -162,6 +162,6 @@ Congratulations! You have created an index, added a small dataset to it, and act
 
 Now you have a basic overview of the basic steps required for setting up and performing AI-powered searches, you might want to try and implement this feature in your own application.
 
-For practical information on implementing AI-powered search with other services, consult our [guides section](/guides/ai/openai). There you will find specific instructions for embedders such as [LangChain](/guides/ai/langchain) and [Cloudflare](/guides/ai/cloudflare).
+For practical information on implementing AI-powered search with other services, consult our [guides section](/guides/embedders/openai). There you will find specific instructions for embedders such as [LangChain](/guides/langchain) and [Cloudflare](/guides/embedders/cloudflare).
 
 For more in-depth information, consult the API reference for [embedder settings](/reference/api/settings#embedders) and [the `hybrid` search parameter](/reference/api/search#hybrid-search).
diff --git a/learn/ai_powered_search/retrieve_related_search_results.mdx b/learn/ai_powered_search/retrieve_related_search_results.mdx
@@ -16,7 +16,7 @@ First, you will create an embedder and add documents to your index. You will the
 
 ## Create a new index
 
-Create an index called `movies` and add this <a href="/movies.json" download="movies.json">`movies.json`</a> dataset to it. If necessary, consult the [getting started](/learn/getting_started/cloud_quick_start) for more instructions on index creation.
+Create an index called `movies` and add this <a href="/assets/datasets/movies.json" download="movies.json">`movies.json`</a> dataset to it. If necessary, consult the [getting started](/learn/getting_started/cloud_quick_start) for more instructions on index creation.
 
 Each document in the dataset represents a single movie and has the following structure:
 
diff --git a/learn/analytics/configure_analytics.mdx b/learn/analytics/configure_analytics.mdx
@@ -26,7 +26,7 @@ Log into your Meilisearch Cloud account and navigate to your project's overview.
 Meilisearch Cloud will begin processing your request. The "Analytics and monitoring" section will update when the feature is enabled.
 
 <Note>
-Activating analytics will automatically activate [monitoring](/learn/analytics/monitoring).
+Activating analytics will automatically activate [monitoring](/learn/analytics/configure_monitoring).
 </Note>
 
 ## Update URLs in your application
diff --git a/learn/analytics/configure_monitoring.mdx b/learn/analytics/configure_monitoring.mdx
@@ -21,7 +21,7 @@ Log into your Meilisearch Cloud account and navigate to your project's overview.
 Meilisearch Cloud will begin processing your request. The "Analytics and monitoring" section will update with new instruction text and buttons when the feature is enabled.
 
 <Note>
-Activating monitoring will automatically activate [analytics](/learn/analytics/analytics).
+Activating monitoring will automatically activate [analytics](/learn/analytics/configure_analytics).
 </Note>
 
 ## Update URLs in your application
diff --git a/learn/data_backup/dumps.mdx b/learn/data_backup/dumps.mdx
@@ -7,7 +7,7 @@ description: Dumps are data backups containing all data related to a Meilisearch
 import CodeSamplesPostDump1 from '/snippets/samples/code_samples_post_dump_1.mdx';
 import CodeSamplesGetTask1 from '/snippets/samples/code_samples_get_task_1.mdx';
 
-A [dump](/learn/advanced/snapshots_vs_dumps#dumps) is a compressed file containing an export of your Meilisearch instance. Use dumps to migrate to new Meilisearch versions. This tutorial shows you how to create and import dumps.
+A [dump](/learn/data_backup/snapshots_vs_dumps#dumps) is a compressed file containing an export of your Meilisearch instance. Use dumps to migrate to new Meilisearch versions. This tutorial shows you how to create and import dumps.
 
 Creating a dump is also referred to as exporting it. Launching Meilisearch with a dump is referred to as importing it.
 
diff --git a/learn/data_backup/snapshots.mdx b/learn/data_backup/snapshots.mdx
@@ -4,7 +4,7 @@ sidebarTitle: Exporting and using Snapshots
 description: Snapshots are exact copies of Meilisearch databases. They are often useful for periodical backups.
 ---
 
-A [snapshot](/learn/advanced/snapshots_vs_dumps#snapshots) is an exact copy of the Meilisearch database. Snapshots are useful as quick backups, but cannot be used to migrate to a new Meilisearch release.
+A [snapshot](/learn/data_backup/snapshots_vs_dumps#snapshots) is an exact copy of the Meilisearch database. Snapshots are useful as quick backups, but cannot be used to migrate to a new Meilisearch release.
 
 This tutorial shows you how to schedule snapshot creation to ensure you always have a recent backup of your instance ready to use. You will also see how to start Meilisearch from this snapshot.
 
diff --git a/learn/data_backup/snapshots_vs_dumps.mdx b/learn/data_backup/snapshots_vs_dumps.mdx
@@ -8,7 +8,7 @@ This article explains Meilisearch's two backup methods: snapshots and dumps.
 
 ## Snapshots
 
-A snapshot is an exact copy of the Meilisearch database, located by default in `./data.ms`. [Use snapshots for quick and efficient backups of your instance](/learn/advanced/snapshots).
+A snapshot is an exact copy of the Meilisearch database, located by default in `./data.ms`. [Use snapshots for quick and efficient backups of your instance](/learn/data_backup/snapshots).
 
 The documents in a snapshot are already indexed and ready to go, greatly increasing import speed. However, snapshots are not compatible between different versions of Meilisearch. Snapshots are also significantly bigger than dumps.
 
diff --git a/learn/engine/storage.mdx b/learn/engine/storage.mdx
@@ -51,7 +51,7 @@ Meilisearch will always demand a certain amount of space to use as a [memory map
 
 ## Measured disk usage
 
-The following measurements were taken using <a href="/movies.json" download="movies.json">movies.json</a> an 8.6 MB JSON dataset containing 19,553 documents.
+The following measurements were taken using <a href="/assets/datasets/movies.json" download="movies.json">movies.json</a> an 8.6 MB JSON dataset containing 19,553 documents.
 
 After indexing, the dataset size in LMDB is about 122MB.
 
diff --git a/learn/getting_started/cloud_quick_start.mdx b/learn/getting_started/cloud_quick_start.mdx
@@ -74,7 +74,7 @@ The final step in creating an index is to add data to it. Choose "File upload":
   <img src="/assets/images/cloud-getting-started/8-file-upload.png" alt="Another modal window with three options. A red arrow points at the chosen option, 'File upload'" />
 </Frame>
 
-Meilisearch Cloud will ask you for your dataset. To follow along, use this <a href="/movies.json" download="movies.json">list of movies</a>. Download the file to your computer, drag and drop it into the indicated area, then click on "Import documents":
+Meilisearch Cloud will ask you for your dataset. To follow along, use this <a href="/assets/datasets/movies.json" download="movies.json">list of movies</a>. Download the file to your computer, drag and drop it into the indicated area, then click on "Import documents":
 
 <Frame>
   <img src="/assets/images/cloud-getting-started/9-data-import.png" alt="Another modal window with a large drag-and-drop area. It indicates a file named 'movies.json' will be uploaded" />
diff --git a/learn/self_hosted/configure_meilisearch_at_launch.mdx b/learn/self_hosted/configure_meilisearch_at_launch.mdx
@@ -136,7 +136,7 @@ Specifying the `config_file_path` option within the configuration file will thro
 
 ## Configuring cloud-hosted instances
 
-To configure Meilisearch with command-line options in a cloud-hosted instance, edit its [service file](/guides/deployment/running_production#step-4-run-meilisearch-as-a-service). The default location of the service file is `/etc/systemd/system/meilisearch.service`.
+To configure Meilisearch with command-line options in a cloud-hosted instance, edit its [service file](/guides/running_production#step-4-run-meilisearch-as-a-service). The default location of the service file is `/etc/systemd/system/meilisearch.service`.
 
 To configure Meilisearch with environment variables in a cloud-hosted instance, modify Meilisearch's `env` file. Its default location is `/var/opt/meilisearch/env`.
 
@@ -424,7 +424,7 @@ For more control over snapshot scheduling, pass an integer representing the inte
 When using the configuration file, it is also possible to explicitly pass a boolean value to `schedule_snapshot`. Meilisearch takes a new snapshot every 24 hours when `schedule_snapshot=true`, and takes no snapshots when `schedule_snapshot=false`.
 </Note>
 
-[Learn more about snapshots](/learn/advanced/snapshots).
+[Learn more about snapshots](/learn/data_backup/snapshots).
 
 ### Snapshot destination
 
diff --git a/learn/self_hosted/getting_started_with_self_hosted_meilisearch.mdx b/learn/self_hosted/getting_started_with_self_hosted_meilisearch.mdx
@@ -73,7 +73,7 @@ To learn more about securing Meilisearch, refer to the [security tutorial](/lear
 
 In this quick start, you will search through a collection of movies.
 
-To follow along, first click this link to download the file: <a href="/movies.json" download="movies.json">movies.json</a>. Then, move the downloaded file into your working directory.
+To follow along, first click this link to download the file: <a href="/assets/datasets/movies.json" download="movies.json">movies.json</a>. Then, move the downloaded file into your working directory.
 
 <Note>
 Meilisearch accepts data in JSON, NDJSON, and CSV formats.
diff --git a/learn/self_hosted/install_meilisearch_locally.mdx b/learn/self_hosted/install_meilisearch_locally.mdx
@@ -64,7 +64,7 @@ docker run -it --rm \
 # Use ${pwd} instead of $(pwd) in PowerShell
 ```
 
-You can learn more about [using Meilisearch with Docker in our dedicated guide](/guides/misc/docker).
+You can learn more about [using Meilisearch with Docker in our dedicated guide](/guides/docker).
 </Tabs.Content>
 
 <Tabs.Content label="APT">
@@ -209,7 +209,7 @@ docker run -it --rm \
 # Use ${pwd} instead of $(pwd) in PowerShell
 ```
 
-Learn more about [using Meilisearch with Docker in our dedicated guide](/guides/misc/docker).
+Learn more about [using Meilisearch with Docker in our dedicated guide](/guides/docker).
 
 </Tabs.Content>
 
diff --git a/learn/update_and_migration/migrating_cloud.mdx b/learn/update_and_migration/migrating_cloud.mdx
@@ -16,7 +16,7 @@ To follow this guide you need:
 
 ## Export a dump from your self-hosted installation
 
-To migrate Meilisearch, you must first [export a dump](/learn/advanced/dumps). A dump is a compressed file containing all your indexes, documents, and settings.
+To migrate Meilisearch, you must first [export a dump](/learn/data_backup/dumps). A dump is a compressed file containing all your indexes, documents, and settings.
 
 To export a dump, make sure your self-hosted Meilisearch instance is running. Then, open your terminal and run the following command, replacing `MEILISEARCH_URL` with your instance's address:
 
diff --git a/learn/update_and_migration/updating.mdx b/learn/update_and_migration/updating.mdx
@@ -13,7 +13,7 @@ import CodeSamplesUpdatingGuideCreateDump from '/snippets/samples/code_samples_u
 import CodeSamplesUpdatingGuideGetDisplayedAttributesOldAuthorizationHeader from '/snippets/samples/code_samples_updating_guide_get_displayed_attributes_old_authorization_header.mdx';
 import CodeSamplesUpdatingGuideResetDisplayedAttributesOldAuthorizationHeader from '/snippets/samples/code_samples_updating_guide_reset_displayed_attributes_old_authorization_header.mdx';
 
-Currently, Meilisearch databases are only compatible with the version of Meilisearch used to create them. The following guide will walk you through using a [dump](/learn/advanced/dumps) to migrate an existing database from an older version of Meilisearch to the most recent one.
+Currently, Meilisearch databases are only compatible with the version of Meilisearch used to create them. The following guide will walk you through using a [dump](/learn/data_backup/dumps) to migrate an existing database from an older version of Meilisearch to the most recent one.
 
 If you're updating your Meilisearch instance on cloud platforms like DigitalOcean or AWS, ensure that you can connect to your cloud instance via SSH. Depending on the user you are connecting with (root, admin, etc.), you may need to prefix some commands with `sudo`.
 
@@ -157,7 +157,7 @@ Meilisearch should launch normally and immediately create a new `UpgradeDatabase
 While the task is processing, you may continue making search queries. You may also enqueue new tasks. Meilisearch will only process new tasks once `UpgradeDatabase` is completed.
 
 <Warning>
-If after the upgrade is completed the task status is set to `failed` or Meilisearch returns internal error messages to your queries, [restart your instance from the snapshot](/learn/advanced/snapshots#starting-from-a-snapshot) you generated during step 1. You may then retry the upgrade, or upgrade using a dump. You are also welcome to open an issue on the [Meilisearch repository](https://github.com/meilisearch/meilisearch).
+If after the upgrade is completed the task status is set to `failed` or Meilisearch returns internal error messages to your queries, [restart your instance from the snapshot](/learn/data_backup/snapshots#starting-from-a-snapshot) you generated during step 1. You may then retry the upgrade, or upgrade using a dump. You are also welcome to open an issue on the [Meilisearch repository](https://github.com/meilisearch/meilisearch).
 </Warning>
 
 ### Using a dump
diff --git a/reference/api/dump.mdx b/reference/api/dump.mdx
@@ -14,7 +14,7 @@ The `/dumps` route allows the creation of database dumps. Dumps are `.dump` file
 Meilisearch Cloud does not support the `/dumps` route.
 </Warning>
 
-[Learn more about dumps](/learn/advanced/dumps).
+[Learn more about dumps](/learn/data_backup/dumps).
 
 ## Create a dump
 
diff --git a/reference/api/snapshots.mdx b/reference/api/snapshots.mdx
@@ -10,7 +10,7 @@ import CodeSamplesCreateSnapshot1 from '/snippets/samples/code_samples_create_sn
 
 The `/snapshot` route allows you to create database snapshots. Snapshots are `.snapshot` files that can be used to make quick backups of Meilisearch data.
 
-[Learn more about snapshots.](/learn/advanced/snapshots)
+[Learn more about snapshots.](/learn/data_backup/snapshots)
 
 <Warning>
 Meilisearch Cloud does not support the `/snapshots` route.
