diff --git a/deploy/multi-repo.mdx b/deploy/multi-repo.mdx
index 514f1e627..d47954822 100644
--- a/deploy/multi-repo.mdx
+++ b/deploy/multi-repo.mdx
@@ -18,6 +18,8 @@ docs.example.com/api
docs.example.com/sdks
```
+One source in a multi-repository deployment can use a root URL path (`/`). Content from that source is served at the root of the site with no path prefix, while other sources are served under their configured URL paths. This is useful when one repository holds the main documentation and other repositories add sections like an API reference or SDK guides.
+
## How multi-repository deployments work
Each repository in a multi-repository deployment has its own:
@@ -44,7 +46,7 @@ One repository acts as the **base source** for the deployment. Its `docs.json` i
- All repository sources must use the same Git provider (all GitHub or all GitLab). Adding a source from a different provider removes all existing sources of the other type
- URL paths must be unique and cannot overlap. For example, do not configure one source at `/docs` and another source at `/docs/api`.
+ URL paths must be unique and cannot overlap. For example, do not configure one source at `/docs` and another source at `/docs/api`. Only one source can use the root URL path (`/`).
## Configure multiple repositories
@@ -81,6 +83,8 @@ One repository acts as the **base source** for the deployment. Its `docs.json` i
The URL path determines where the content from that repository appears on your docs site. For example, a URL path of `api` serves the content under `docs.example.com/api`.
+ To serve a source at the root of your site with no path prefix, leave the URL path empty or set it to `/`. Only one source per deployment can use the root URL path.
+
You can enter the path with or without leading slashes. Mintlify normalizes the value when you save.
@@ -164,6 +168,10 @@ In this example, `/api` is the URL path configured for the API repository source
Do not use full `https://` URLs for internal cross-source links. Root-relative paths keep previews and custom domains working correctly.
+### Avoid path conflicts across sources
+
+When one source uses the root URL path, its pages can share the same final URL as pages in another source. If two sources produce the same page path, Mintlify serves the page from the source with the more specific URL path and logs a conflict warning in the deployment update. To avoid conflicts, keep filenames in the root source from overlapping with URL paths configured for other sources.
+
## Reference navigation from another source
Use `sourceRef` to place another repository's navigation at a specific location in the base source's `docs.json`. If you don't use `sourceRef`, Mintlify adds each repository as a separate top-level product section.
diff --git a/es/deploy/multi-repo.mdx b/es/deploy/multi-repo.mdx
index 05499d628..b1149cdb2 100644
--- a/es/deploy/multi-repo.mdx
+++ b/es/deploy/multi-repo.mdx
@@ -18,6 +18,8 @@ docs.example.com/api
docs.example.com/sdks
```
+Una fuente en una implementación multi-repositorio puede usar una ruta de URL raíz (`/`). El contenido de esa fuente se sirve en la raíz del sitio sin prefijo de ruta, mientras que las demás fuentes se sirven bajo sus rutas de URL configuradas. Esto es útil cuando un repositorio contiene la documentación principal y otros repositorios añaden secciones como una referencia de API o guías de SDK.
+
## Cómo funcionan las implementaciones multi-repositorio
@@ -48,7 +50,7 @@ Un repositorio actúa como la **fuente base** de la implementación. Su `docs.js
- Todas las fuentes de repositorio deben usar el mismo proveedor de Git (todas GitHub o todas GitLab). Añadir una fuente de un proveedor distinto elimina todas las fuentes existentes del otro tipo
- Las rutas de URL deben ser únicas y no pueden superponerse. Por ejemplo, no configures una fuente en `/docs` y otra fuente en `/docs/api`.
+ Las rutas de URL deben ser únicas y no pueden superponerse. Por ejemplo, no configures una fuente en `/docs` y otra fuente en `/docs/api`. Solo una fuente puede usar la ruta de URL raíz (`/`).
@@ -87,6 +89,8 @@ Un repositorio actúa como la **fuente base** de la implementación. Su `docs.js
La ruta de URL determina dónde aparece el contenido de ese repositorio en tu sitio de documentación. Por ejemplo, una ruta de URL `api` sirve el contenido bajo `docs.example.com/api`.
+ Para servir una fuente en la raíz de tu sitio sin prefijo de ruta, deja la ruta de URL vacía o establécela en `/`. Solo una fuente por implementación puede usar la ruta de URL raíz.
+
Puedes introducir la ruta con o sin barras iniciales. Mintlify normaliza el valor al guardar.
@@ -178,6 +182,12 @@ En este ejemplo, `/api` es la ruta URL configurada para la fuente del repositori
No uses URLs completas con `https://` para enlaces internos entre fuentes: las rutas relativas a la raíz mantienen el correcto funcionamiento de las previsualizaciones y los dominios personalizados.
+
+ ### Evitar conflictos de rutas entre fuentes
+
+
+Cuando una fuente usa la ruta de URL raíz, sus páginas pueden compartir la misma URL final que las páginas de otra fuente. Si dos fuentes producen la misma ruta de página, Mintlify sirve la página desde la fuente con la ruta de URL más específica y registra una advertencia de conflicto en la actualización de la implementación. Para evitar conflictos, procura que los nombres de archivo de la fuente raíz no se superpongan con las rutas de URL configuradas para otras fuentes.
+
## Referenciar la navegación desde otra fuente
diff --git a/fr/deploy/multi-repo.mdx b/fr/deploy/multi-repo.mdx
index 13d5a4da0..70956c6e2 100644
--- a/fr/deploy/multi-repo.mdx
+++ b/fr/deploy/multi-repo.mdx
@@ -18,6 +18,8 @@ docs.example.com/api
docs.example.com/sdks
```
+Une source d’un déploiement multi-référentiels peut utiliser un chemin d’URL racine (`/`). Le contenu de cette source est diffusé à la racine du site sans préfixe de chemin, tandis que les autres sources sont diffusées sous leurs chemins d’URL configurés. C’est utile lorsqu’un référentiel contient la documentation principale et que d’autres référentiels ajoutent des sections comme une référence d’API ou des guides SDK.
+
## Fonctionnement des déploiements multi-référentiels
@@ -48,7 +50,7 @@ Un référentiel sert de **source de base** pour le déploiement. Son `docs.json
- Toutes les sources doivent utiliser le même fournisseur Git (tout GitHub ou tout GitLab). L’ajout d’une source d’un autre fournisseur supprime toutes les sources existantes de l’autre type
- Les chemins d’URL doivent être uniques et ne peuvent pas se chevaucher. Par exemple, ne configurez pas une source sur `/docs` et une autre sur `/docs/api`.
+ Les chemins d’URL doivent être uniques et ne peuvent pas se chevaucher. Par exemple, ne configurez pas une source sur `/docs` et une autre sur `/docs/api`. Une seule source peut utiliser le chemin d’URL racine (`/`).
@@ -87,6 +89,8 @@ Un référentiel sert de **source de base** pour le déploiement. Son `docs.json
Le chemin d’URL détermine l’emplacement où le contenu de ce référentiel apparaît sur votre site de documentation. Par exemple, un chemin d’URL `api` diffuse le contenu sous `docs.example.com/api`.
+ Pour diffuser une source à la racine de votre site sans préfixe de chemin, laissez le chemin d’URL vide ou définissez-le sur `/`. Une seule source par déploiement peut utiliser le chemin d’URL racine.
+
Vous pouvez saisir le chemin avec ou sans barre oblique de tête. Mintlify normalise la valeur lors de l’enregistrement.
@@ -178,6 +182,12 @@ Dans cet exemple, `/api` est le chemin d’URL configuré pour la source du réf
N’utilisez pas d’URL complètes `https://` pour les liens internes entre sources — les chemins relatifs à la racine permettent aux previews et aux domaines personnalisés de continuer à fonctionner correctement.
+
+ ### Éviter les conflits de chemins entre les sources
+
+
+Lorsqu’une source utilise le chemin d’URL racine, ses pages peuvent partager la même URL finale que des pages d’une autre source. Si deux sources produisent le même chemin de page, Mintlify diffuse la page depuis la source dont le chemin d’URL est le plus spécifique et enregistre un avertissement de conflit dans la mise à jour du déploiement. Pour éviter les conflits, veillez à ce que les noms de fichiers de la source racine ne chevauchent pas les chemins d’URL configurés pour les autres sources.
+
## Référencer la navigation d'une autre source
diff --git a/zh/deploy/multi-repo.mdx b/zh/deploy/multi-repo.mdx
index 5511d80cf..f97f4b234 100644
--- a/zh/deploy/multi-repo.mdx
+++ b/zh/deploy/multi-repo.mdx
@@ -18,6 +18,8 @@ docs.example.com/api
docs.example.com/sdks
```
+多仓库部署中可以有一个源使用根 URL 路径(`/`)。来自该源的内容会在站点根路径下提供,不带任何路径前缀,而其他源则在各自配置的 URL 路径下提供。当一个仓库存放主文档、其他仓库添加 API 参考或 SDK 指南等分区时,这一点非常有用。
+
## 多仓库部署的工作原理
@@ -48,7 +50,7 @@ docs.example.com/sdks
- 所有源仓库必须使用相同的 Git 提供方(全部为 GitHub 或全部为 GitLab)。添加来自不同提供方的源会移除所有现有的另一类型的源
- URL 路径必须唯一且不能重叠。例如,不要同时将一个源配置为 `/docs`,另一个源配置为 `/docs/api`。
+ URL 路径必须唯一且不能重叠。例如,不要同时将一个源配置为 `/docs`,另一个源配置为 `/docs/api`。只有一个源可以使用根 URL 路径(`/`)。