Update translations

es/ai/mintlify-mcp.mdx

@@ -181,11 +181,15 @@ Para publicar tus cambios, pide a la herramienta de IA que solicite una revisió
 
 Llama a `create_branch` con un `title` cuando tu proyecto requiera una pull request, o cuando quieras una de todos modos. Mintlify crea una nueva rama a partir de tu rama de despliegue, la nombra `<your-name>/<title-slug>` igual que el editor del panel nombra las ramas, y la inicializa a partir de tu contenido publicado. La pull request se abre con este título. Por ejemplo, `create_branch { subdomain: "acme", title: "Add tips page" }`.
 
+Para empezar desde otra rama existente, como una rama de funcionalidad para una actualización grande, pasa su nombre como `from`. Por ejemplo, `create_branch { subdomain: "acme", title: "Add tips page", from: "docs-refresh" }`. Mintlify rechaza las ramas `from` que no existen y no crea nada.
+
+Si tu repositorio está en GitHub, GitLab o Azure Repos, una rama que empiezas desde una rama distinta de tu rama de despliegue se convierte en una [sub-branch](/es/editor/publish#sub-branches), y su pull request apunta a la rama `from` en lugar de a tu rama de despliegue.
+
 `create_branch` devuelve el `branchName`, la `baseBranch` y el `baseSha` desde los que empezó, una `note` y un `editorUrl` que puedes abrir para seguir el progreso en el editor del panel. Pasa el `branchName` como `branch` en todas las llamadas posteriores.
 
 Para trabajar en una rama existente, pasa su nombre como `branch`. Llama a `list_branches` para descubrir las ramas del repositorio de un proyecto. Mintlify rechaza las llamadas sobre ramas que no existen.
 
-En una rama, Mintlify hace commit de tus ediciones automáticamente, aproximadamente 15 segundos después del último cambio. Esto incluye el contenido de las páginas, los cambios de navegación y las actualizaciones de `docs.json`. El primer commit abre una pull request contra tu rama de despliegue. La pull request se abre como borrador si [Create draft pull requests by default](/es/editor/settings#create-draft-pull-requests-by-default) está activado. Nada llega a tu rama de despliegue hasta que alguien hace merge de la pull request.
+En una rama, Mintlify hace commit de tus ediciones automáticamente, aproximadamente 15 segundos después del último cambio. Esto incluye el contenido de las páginas, los cambios de navegación y las actualizaciones de `docs.json`. El primer commit abre una pull request contra tu rama de despliegue, o contra la rama `from` en el caso de una sub-branch. La pull request se abre como borrador si [Create draft pull requests by default](/es/editor/settings#create-draft-pull-requests-by-default) está activado. Nada llega a tu rama de despliegue hasta que alguien hace merge de los cambios en ella.
 
 `discard` en una rama distinta de tu rama de despliegue elimina la rama y cierra su pull request, aunque la rama tenga commits. Equivale a eliminar una rama en el editor del panel. `discard` solo elimina ramas que creaste en Mintlify. Para cualquier otra rama, lo rechaza y no cambia nada.
 
@@ -368,7 +372,7 @@ Estas herramientas solo aparecen cuando tu proyecto [requiere revisión antes de
 </div>
 
 - **`list_deployments`**: Lista los proyectos a los que tu conexión puede acceder, devolviendo cada `{subdomain, name, projectType}`. `projectType` es `site` para un sitio de documentación o `workspace` para una base. Llama a esto para descubrir qué `subdomain` pasar.
-- **`create_branch`**: Crea una nueva rama a partir de tu rama de despliegue con un `title` que también nombra su pull request. Devuelve el `branchName` que debes pasar como `branch`. Consulta [Trabajar en una rama](#work-on-a-branch). No lo necesitas para [editar la rama de despliegue directamente](#edit-the-deploy-branch-directly).
+- **`create_branch`**: Crea una nueva rama a partir de tu rama de despliegue, o de la rama existente que pases como `from`, con un `title` que también nombra su pull request. Devuelve el `branchName` que debes pasar como `branch`. Consulta [Trabajar en una rama](#work-on-a-branch). No lo necesitas para [editar la rama de despliegue directamente](#edit-the-deploy-branch-directly).
 - **`list_branches`**: Lista las ramas de Git disponibles para el repositorio de un proyecto, con filtrado opcional por `query`. Devuelve los nombres de las ramas, el total y la rama de despliegue. Pasa cualquiera de ellas como `branch`.
 - **`status`**: Lista los archivos editados, las claves de `docs.json` modificadas y el diff de navegación pendiente en `branch`, o en tu rama de despliegue cuando lo omites. En la rama de despliegue, lista solo tus cambios.
 - **`diff`**: Lista todos los cambios entre `branch` y tu rama de despliegue. Cada archivo modificado y la entrada de `docs.json` incluyen `authors` y `byYou`. `authors` enumera los miembros cuyas ediciones no publicadas contiene la entrada. `byYou` es `true` cuando la entrada incluye tus propias ediciones. Usa `byYou` para distinguir tus cambios de los de un colega en una rama compartida.

es/editor/review.mdx

@@ -232,7 +232,9 @@ Si Mintlify aloja su repositorio y no se requieren aprobaciones, el menú de pub
 
 Haga clic en cualquier archivo modificado del menú de publicación para abrirlo en la vista de diff frente a la versión publicada. Para salir de la vista de diff, haga clic en **Viewing changes** en la barra superior. El modo visual muestra un diff visual y el modo source muestra un diff de texto. Los archivos que no pueden mostrar un diff, como las imágenes o los archivos eliminados, aparecen en la lista pero no se pueden abrir.
 
-En un diff en modo source de una página, elija **Unified** o **Split** en la barra superior para mostrar los cambios en una columna o uno al lado del otro. Hasta que elija, el editor usa el diseño que mejor se ajusta al ancho de su ventana. El editor recuerda su elección para los diffs posteriores.
+Para comparar `docs.json` con la versión de la branch en la que se publican sus cambios, abra `docs.json` en modo source y haga clic en **Show changes** en la barra superior. El editor muestra un diff de texto de solo lectura. Haga clic en **Hide changes** para volver a editar.
+
+En un diff en modo source de una página o de `docs.json`, elija **Unified** o **Split** en la barra superior para mostrar los cambios en una columna o uno al lado del otro. Hasta que elija, el editor usa el diseño que mejor se ajusta al ancho de su ventana. El editor recuerda su elección para los diffs posteriores.
 
 Puede abrir desde el menú de publicación las [páginas ocultas](/es/organize/hidden-pages) que aparecen en el diff de la branch, aunque no figuren en la navegación de su sitio.
 

fr/ai/mintlify-mcp.mdx

@@ -181,11 +181,15 @@ Pour faire publier vos modifications, demandez à l'outil d'IA de demander une r
 
 Appelez `create_branch` avec un `title` lorsque votre projet exige une pull request, ou lorsque vous en voulez une malgré tout. Mintlify crée une nouvelle branche à partir de votre branche de déploiement, la nomme `<your-name>/<title-slug>` comme l'éditeur du tableau de bord nomme les branches, et l'initialise à partir de votre contenu publié. La pull request s'ouvre avec ce titre. Par exemple, `create_branch { subdomain: "acme", title: "Add tips page" }`.
 
+Pour partir d'une autre branche existante, comme une branche de fonctionnalité pour une mise à jour importante, passez son nom comme `from`. Par exemple, `create_branch { subdomain: "acme", title: "Add tips page", from: "docs-refresh" }`. Mintlify refuse les branches `from` qui n'existent pas et ne crée rien.
+
+Si votre dépôt est hébergé sur GitHub, GitLab ou Azure Repos, une branche que vous créez à partir d'une branche autre que votre branche de déploiement devient une [sous-branch](/fr/editor/publish#sub-branches), et sa pull request cible la branche `from` au lieu de votre branche de déploiement.
+
 `create_branch` renvoie le `branchName`, la `baseBranch` et le `baseSha` de départ, une `note` et un `editorUrl` que vous pouvez ouvrir pour suivre l'avancement dans l'éditeur du tableau de bord. Passez le `branchName` comme `branch` dans tous les appels suivants.
 
 Pour travailler sur une branche existante, passez son nom comme `branch`. Appelez `list_branches` pour découvrir les branches du dépôt d'un projet. Mintlify refuse les appels sur des branches qui n'existent pas.
 
-Sur une branche, Mintlify commite automatiquement vos modifications, environ 15 secondes après la dernière modification. Cela inclut le contenu des pages, les modifications de navigation et les mises à jour de `docs.json`. Le premier commit ouvre une pull request vers votre branche de déploiement. La pull request s'ouvre en brouillon si [Create draft pull requests by default](/fr/editor/settings#create-draft-pull-requests-by-default) est activé. Rien n'atteint votre branche de déploiement tant que quelqu'un n'a pas fusionné la pull request.
+Sur une branche, Mintlify commite automatiquement vos modifications, environ 15 secondes après la dernière modification. Cela inclut le contenu des pages, les modifications de navigation et les mises à jour de `docs.json`. Le premier commit ouvre une pull request vers votre branche de déploiement, ou vers la branche `from` pour une sous-branch. La pull request s'ouvre en brouillon si [Create draft pull requests by default](/fr/editor/settings#create-draft-pull-requests-by-default) est activé. Rien n'atteint votre branche de déploiement tant que quelqu'un n'y a pas fusionné les modifications.
 
 `discard` sur une branche autre que votre branche de déploiement supprime la branche et ferme sa pull request, même si la branche contient des commits. Cela équivaut à supprimer une branche dans l'éditeur du tableau de bord. `discard` ne supprime que les branches que vous avez créées dans Mintlify. Pour toute autre branche, il refuse et ne change rien.
 
@@ -368,7 +372,7 @@ Ces outils n'apparaissent que lorsque votre projet [exige une relecture avant pu
 </div>
 
 - **`list_deployments`**: Liste les projets auxquels votre connexion peut accéder, en renvoyant chaque `{subdomain, name, projectType}`. `projectType` vaut `site` pour un site de documentation ou `workspace` pour une base. Appelez ceci pour découvrir quel `subdomain` transmettre.
-- **`create_branch`**: Crée une nouvelle branche à partir de votre branche de déploiement avec un `title` qui nomme aussi sa pull request. Renvoie le `branchName` à passer comme `branch`. Consultez [Travailler sur une branche](#work-on-a-branch). Vous n'en avez pas besoin pour [modifier directement la branche de déploiement](#edit-the-deploy-branch-directly).
+- **`create_branch`**: Crée une nouvelle branche à partir de votre branche de déploiement, ou de la branche existante que vous passez comme `from`, avec un `title` qui nomme aussi sa pull request. Renvoie le `branchName` à passer comme `branch`. Consultez [Travailler sur une branche](#work-on-a-branch). Vous n'en avez pas besoin pour [modifier directement la branche de déploiement](#edit-the-deploy-branch-directly).
 - **`list_branches`**: Liste les branches Git disponibles pour le dépôt d'un projet, avec un filtrage `query` optionnel. Renvoie les noms de branches, le nombre total et la branche de déploiement. Passez n'importe laquelle comme `branch`.
 - **`status`**: Liste les fichiers modifiés, les clés `docs.json` modifiées et le diff de navigation en attente sur `branch`, ou sur votre branche de déploiement lorsque vous l'omettez. Sur la branche de déploiement, liste uniquement vos modifications.
 - **`diff`**: Liste toutes les modifications entre `branch` et votre branche de déploiement. Chaque fichier modifié et chaque entrée `docs.json` incluent `authors` et `byYou`. `authors` liste les membres dont l'entrée contient les modifications non publiées. `byYou` vaut `true` lorsque l'entrée inclut vos propres modifications. Utilisez `byYou` pour distinguer vos modifications de celles d'un collègue sur une branche partagée.

fr/editor/review.mdx

@@ -232,7 +232,9 @@ Si Mintlify héberge votre dépôt et qu'aucune approbation n'est requise, le me
 
 Cliquez sur n'importe quel fichier modifié dans le menu de publication pour l'ouvrir en vue diff face à la version publiée. Pour quitter la vue diff, cliquez sur **Viewing changes** dans la barre supérieure. Le mode visuel affiche un diff visuel et le mode source affiche un diff textuel. Les fichiers qui ne peuvent pas afficher de diff, comme les images ou les fichiers supprimés, figurent dans la liste mais ne sont pas cliquables.
 
-Dans un diff en mode source d'une page, choisissez **Unified** ou **Split** dans la barre supérieure pour afficher les modifications sur une colonne ou côte à côte. Tant que vous n'avez pas choisi, l'éditeur sélectionne la disposition adaptée à la largeur de votre fenêtre. L'éditeur mémorise votre choix pour les diffs suivants.
+Pour comparer `docs.json` avec la version de la branch sur laquelle vos modifications sont publiées, ouvrez `docs.json` en mode source et cliquez sur **Show changes** dans la barre supérieure. L'éditeur affiche un diff textuel en lecture seule. Cliquez sur **Hide changes** pour revenir à l'édition.
+
+Dans un diff en mode source d'une page ou de `docs.json`, choisissez **Unified** ou **Split** dans la barre supérieure pour afficher les modifications sur une colonne ou côte à côte. Tant que vous n'avez pas choisi, l'éditeur sélectionne la disposition adaptée à la largeur de votre fenêtre. L'éditeur mémorise votre choix pour les diffs suivants.
 
 Vous pouvez ouvrir depuis le menu de publication les [pages masquées](/fr/organize/hidden-pages) qui apparaissent dans le diff de la branch, même si elles ne figurent pas dans la navigation de votre site.
 

zh/ai/mintlify-mcp.mdx

@@ -181,11 +181,15 @@ Mintlify 会在每次编辑时检查这些条件，并将你的 branch 保护规
 
 当你的项目要求拉取请求，或者你本身就想要一个拉取请求时，请调用 `create_branch` 并传入 `title`。Mintlify 会从部署 branch 创建一个新的 branch，按照与控制台编辑器相同的方式将其命名为 `<your-name>/<title-slug>`，并基于你已发布的内容进行初始化。拉取请求会以此标题打开。例如 `create_branch { subdomain: "acme", title: "Add tips page" }`。
 
+如果要改为从另一个现有 branch 开始（例如用于大型更新的功能 branch），请将其名称作为 `from` 传入。例如 `create_branch { subdomain: "acme", title: "Add tips page", from: "docs-refresh" }`。如果 `from` branch 不存在，Mintlify 会拒绝请求，且不会创建任何内容。
+
+如果你的仓库位于 GitHub、GitLab 或 Azure Repos 上，从部署 branch 以外的 branch 开始创建的 branch 会成为[子分支](/zh/editor/publish#sub-branches)，其拉取请求以 `from` branch 而不是部署 branch 为目标。
+
 `create_branch` 返回 `branchName`、起始的 `baseBranch` 和 `baseSha`、一个 `note`，以及一个可在控制台编辑器中实时跟进的 `editorUrl`。在之后的每次调用中，将 `branchName` 作为 `branch` 传入。
 
 要在现有 branch 上工作，请将其名称作为 `branch` 传入。调用 `list_branches` 可发现项目仓库中的 branch。Mintlify 会拒绝针对不存在的 branch 的调用。
 
-在 branch 上，Mintlify 会在最后一次更改约 15 秒后自动提交你的编辑，包括页面内容、导航更改和 `docs.json` 更新。首次提交会打开一个针对部署 branch 的拉取请求。如果启用了[默认创建草稿 pull request](/zh/editor/settings#create-draft-pull-requests-by-default)，拉取请求会以草稿形式打开。在有人合并该拉取请求之前，任何更改都不会进入你的部署 branch。
+在 branch 上，Mintlify 会在最后一次更改约 15 秒后自动提交你的编辑，包括页面内容、导航更改和 `docs.json` 更新。首次提交会打开一个针对部署 branch 的拉取请求；对于子分支，则针对 `from` branch。如果启用了[默认创建草稿 pull request](/zh/editor/settings#create-draft-pull-requests-by-default)，拉取请求会以草稿形式打开。在有人将这些更改合并到你的部署 branch 之前，任何更改都不会进入其中。
 
 在部署 branch 以外的 branch 上，`discard` 会删除该 branch 并关闭其拉取请求，即使该 branch 已有提交。这与在控制台编辑器中删除 branch 的效果相同。`discard` 只会删除你在 Mintlify 中创建的 branch。对于其他 branch，它会拒绝操作且不做任何更改。
 
@@ -368,7 +372,7 @@ curl -X PUT --upload-file ./dashboard.png -H 'Content-Type: image/png' '<uploadU
 </div>
 
 - **`list_deployments`**: 列出你的连接可以访问的项目，返回每个 `{subdomain, name, projectType}`。`projectType` 为 `site` 表示文档站点，为 `workspace` 表示 Base。调用此项以了解要传递的 `subdomain`。
-- **`create_branch`**: 从部署 branch 创建一个新的 branch，并传入同时用作其拉取请求标题的 `title`。返回要作为 `branch` 传入的 `branchName`。参见[在 branch 上工作](#work-on-a-branch)。[直接编辑部署 branch](#edit-the-deploy-branch-directly) 时不需要它。
+- **`create_branch`**: 从部署 branch 或你作为 `from` 传入的现有 branch 创建一个新的 branch，并传入同时用作其拉取请求标题的 `title`。返回要作为 `branch` 传入的 `branchName`。参见[在 branch 上工作](#work-on-a-branch)。[直接编辑部署 branch](#edit-the-deploy-branch-directly) 时不需要它。
 - **`list_branches`**: 列出某个项目仓库可用的 Git branch，可选用 `query` 进行筛选。返回 branch 名称、总数以及部署 branch。其中任意一个都可以作为 `branch` 传入。
 - **`status`**: 列出 `branch`（省略时为部署 branch）上已编辑的文件、已更改的 `docs.json` 键和待处理的导航差异。在部署 branch 上，只列出你的更改。
 - **`diff`**: 列出 `branch` 与你的部署 branch 之间的所有更改。每个已更改的文件和 `docs.json` 条目都包含 `authors` 和 `byYou`。`authors` 列出该条目中包含其未发布编辑的成员。当该条目包含你自己的编辑时，`byYou` 为 `true`。在共享 branch 上，可使用 `byYou` 区分你的更改和同事的更改。

zh/editor/review.mdx

@@ -232,7 +232,9 @@ branch 上的审阅涵盖整个 branch。branch 的每个页面都显示同一
 
 在发布菜单中点击任意已更改的文件，即可在 diff 视图中将其与已发布版本进行比较。若要退出 diff 视图，请点击顶部栏中的 **Viewing changes**。可视化模式会显示可视化 diff，source 模式会显示文本 diff。无法显示 diff 的文件（例如图片或已删除的文件）会出现在列表中，但无法点击。
 
-在页面的 source 模式 diff 中，在顶部栏中选择 **Unified** 或 **Split**，即可以单列或并排方式显示更改。在你做出选择之前，编辑器会根据窗口宽度选择合适的布局。编辑器会记住你的选择，并应用于之后的 diff。
+若要将 `docs.json` 与你的更改所发布到的分支上的版本进行比较，请在 source 模式下打开 `docs.json`，然后点击顶部栏中的 **Show changes**。编辑器会显示只读的文本 diff。点击 **Hide changes** 即可返回编辑。
+
+在页面或 `docs.json` 的 source 模式 diff 中，在顶部栏中选择 **Unified** 或 **Split**，即可以单列或并排方式显示更改。在你做出选择之前，编辑器会根据窗口宽度选择合适的布局。编辑器会记住你的选择，并应用于之后的 diff。
 
 出现在分支 diff 中的[隐藏页面](/zh/organize/hidden-pages)也可以从发布菜单中打开，即使它们并未出现在站点导航中。