mintlify · ethanpalm · Sep 8, 2026 · Sep 1, 2026 · Sep 1, 2026 · Sep 8, 2026
diff --git a/ai/bring-your-own-model.mdx b/ai/bring-your-own-model.mdx
@@ -19,8 +19,8 @@ Bring your own model applies to a single deployment, not to your whole organizat
 | Provider | Coverage |
 |:---------|:---------|
 | OpenRouter | Full. Every AI product uses your key and your model. |
-| Anthropic | Limited. Some AI products continue to use Mintlify's models. |
-| OpenAI-compatible | Limited. Some AI products continue to use Mintlify's models. |
+| Anthropic | Limited. The assistant uses your key. The agent and automations continue to use Mintlify's models. |
+| OpenAI-compatible | Limited. The assistant uses your key. The agent and automations continue to use Mintlify's models. |
 
 Each provider supports a fixed set of models.
 

diff --git a/cli/commands.mdx b/cli/commands.mdx
@@ -30,7 +30,7 @@
 | --- | --- |
 | `--port` | Port to run the local preview on. Defaults to `3000`. |
 | `--no-open` | Do not open the browser automatically. |
-| `--groups` | Comma-separated list of user groups to mock for preview. |
+| `--groups` | Space-separated list of user groups to mock for preview. For example, `--groups admin user`. |
 | `--disable-openapi` | Skip OpenAPI file processing to improve performance. |
 | `--disable-prefetch` | Disable navigation prefetching in the local preview. Useful for very large sites where background prefetching slows down page loads. |
 | `--local-schema` | Allow locally hosted OpenAPI files served over HTTP. |
@@ -93,9 +93,9 @@

 | Client | Global configuration | Project configuration |
 | --- | --- | --- |
 | Claude Code | `~/.claude.json` | `.mcp.json` |
 | Cursor | `~/.cursor/mcp.json` | `.cursor/mcp.json` |
 | VS Code | User `mcp.json` | `.vscode/mcp.json` |
 | Codex | `~/.codex/config.toml` | `.codex/config.toml` |
 | OpenCode | `~/.config/opencode/opencode.json` | `opencode.json` |
 | Windsurf | `~/.codeium/windsurf/mcp_config.json` | Global only |
@@ -204,7 +204,7 @@

 Add the `TXT` records first, then add the `CNAME` once the verification records validate. See [Custom domain](/customize/custom-domain) for full DNS setup instructions, apex domain requirements, and TLS provisioning details.

 If the command fails with `Domain is already in use by another deployment in your organization` or `Domain is already claimed by another organization`, the domain is bound to another Mintlify deployment. See [Add domain fails with "Domain is already claimed by another organization"](/help-center/domain-already-claimed-by-another-organization) to release it and re-add it.

 <Note>
  If some `TXT` records are still generating when the command exits, check the [Custom domain setup](https://app.mintlify.com/settings/deployment/custom-domain) page in your dashboard for the remaining values.
@@ -351,7 +351,7 @@

 ### `mint analytics stats`

 Display top-line KPIs for a date range: views, visitors, searches, feedback, and assistant usage. The output reports human and agent traffic separately.

 ```bash
 mint analytics stats [flags]
@@ -500,7 +500,7 @@
 | `--check-redirects` | Also check that redirect destinations in `docs.json` resolve to valid paths. |
 | `--check-snippets` | Also check links inside `<Snippet>` components. |

 Pass `--files` to limit the check to specific pages. This is useful for validating a single page you just edited or scoping checks to a directory in CI. When `--files` is set with `--check-external`, only external URLs on the selected pages are fetched.

 ```bash
 # Check a specific page
@@ -542,7 +542,7 @@
 
 | Flag | Description |
 | --- | --- |
-| `--groups` | Comma-separated list of user groups to mock for validation. |
+| `--groups` | Space-separated list of user groups to mock for validation. For example, `--groups admin user`. |
 | `--disable-openapi` | Skip OpenAPI file processing and validation. |
 | `--local-schema` | Allow validation of locally hosted OpenAPI files served over HTTP. Only supports HTTPS in production. |
 
@@ -610,7 +610,7 @@
 | Flag | Description |
 | --- | --- |
 | `--output` | Output filename. Defaults to `export.zip`. |
-| `--groups` | Comma-separated list of user groups to include restricted pages for. |
+| `--groups` | Space-separated list of user groups to include restricted pages for. For example, `--groups admin user`. |
 | `--disable-openapi` | Skip OpenAPI processing. |
 
 See [Offline export](/deploy/export) for details.
@@ -686,13 +686,13 @@
 mint format
 ```

 Run the command from the root of your docs project. It walks every subdirectory, skipping paths matched by `.gitignore` and any Mintlify ignore rules. Files that already match the canonical output are left untouched.

 <Warning>
  `mint format` rewrites files in place. Commit or stash your changes before running it so you can review the diff.
 </Warning>

 When it finishes, the command prints how many MDX files were reformatted and how many failed to parse. If any file fails, the command exits with code `1` and prints the file path and error, so you can run it in CI to enforce consistent formatting. See [Install in CI](/cli/install#install-in-ci) for an example pipeline.

 ---

@@ -746,7 +746,7 @@

 ## Telemetry

 The CLI collects usage telemetry to help improve Mintlify. Telemetry data includes the command name, CLI version, operating system, and architecture. If you are logged in, telemetry events also include your account email address. Logged-out usage stays anonymous, and logging out removes your stored email. Mintlify does **not** collect project content or file paths.

 By default, the CLI collects telemetry data. You can opt out at any time using the `--telemetry` flag:


diff --git a/editor/settings.mdx b/editor/settings.mdx
@@ -8,7 +8,7 @@
 The editor [settings page](https://app.mintlify.com/settings/deployment/editor) controls the appearance, publishing behavior, and agent behavior.
 
 - **Appearance**: Personal preferences for how the editor looks and behaves. These apply only to you.
-- **Publishing**: Deployment-wide defaults for how the editor commits changes and opens pull requests. These apply to everyone who publishes.
+- **Publishing**: Deployment-wide defaults for how the editor commits changes and opens pull requests. These apply to everyone who publishes. Only admins can update publishing behavior.
 - **Chat**: Persistent instructions for the editor's AI agent.
 - **Danger zone**: Actions that can't be undone.
 
@@ -40,7 +40,7 @@
 using its relative path.
 ```

 Instructions are limited to 20,000 characters.

 ## Main branch autocommits

@@ -50,6 +50,12 @@
   With main branch autocommits on, there is no pending state and no chance to review. Every edit reaches your live site shortly after you stop typing.
 </Warning>
 
+## Create draft pull requests by default
+
+When this setting is on, pull requests created from the editor open as drafts. Authors mark them ready for review when they finish editing. This setting is on by default.
+
+If you want editor pull requests to open ready for review immediately, turn off draft pull requests.
+
 ## PR merge method
 
 Choose how the editor merges pull requests when you click **Merge and publish**:
@@ -73,7 +79,7 @@
 - **Edit with AI** actions on a selection, such as rewrite, expand, or fix.
 - **Agent sessions** started from the editor.

 Each teammate maintains their own instructions, scoped to their user account. Instructions are limited to 20,000 characters.

 Add AI instructions when you find yourself repeating the same guidance in prompts, for example:


diff --git a/es/ai/bring-your-own-model.mdx b/es/ai/bring-your-own-model.mdx
@@ -1,6 +1,6 @@
 ---
 title: "Usa tu propio modelo"
-description: "Usa tu propia clave de API de un proveedor de LLM y elige el modelo que impulsa el assistant, el agente y las automatizaciones de Mintlify en los planes Enterprise."
+description: "Usa tu propia clave de API de LLM y elige el modelo que impulsa el assistant, el agente y las automatizaciones de Mintlify en planes Enterprise."
 keywords: ["BYOK", "clave", "OpenRouter", "Anthropic", "OpenAI", "LLM", "clave de API", "créditos"]
 ---
 
@@ -21,8 +21,10 @@ Usar tu propio modelo se aplica a un solo deployment, no a toda tu organización
 | Proveedor | Cobertura |
 |:---------|:---------|
 | OpenRouter | Completa. Todos los productos de IA usan tu clave y tu modelo. |
-| Anthropic | Limitada. Algunos productos de IA siguen usando los modelos de Mintlify. |
-| Compatible con OpenAI | Limitada. Algunos productos de IA siguen usando los modelos de Mintlify. |
+| Anthropic | Limitada. El assistant usa tu clave. El agente y las automatizaciones siguen usando los modelos de Mintlify. |
+| Compatible con OpenAI | Limitada. El assistant usa tu clave. El agente y las automatizaciones siguen usando los modelos de Mintlify. |
+
+Para ejecutar todos los productos de IA con tu propia clave, usa OpenRouter.
 
 Cada proveedor admite un conjunto fijo de modelos.
 

diff --git a/es/cli/commands.mdx b/es/cli/commands.mdx
@@ -34,7 +34,7 @@ mint dev [flags]
 | --- | --- |
 | `--port` | Puerto para ejecutar la previsualización local. Por defecto `3000`. |
 | `--no-open` | No abrir el navegador automáticamente. |
-| `--groups` | Lista separada por comas de grupos de usuarios a simular para la previsualización. |
+| `--groups` | Lista separada por espacios de grupos de usuarios a simular para la previsualización. Por ejemplo, `--groups admin user`. |
 | `--disable-openapi` | Omitir el procesamiento de archivos OpenAPI para mejorar el rendimiento. |
 | `--disable-prefetch` | Deshabilitar la precarga de navegación en la vista previa local. Útil para sitios muy grandes donde la precarga en segundo plano ralentiza la carga de páginas. |
 | `--local-schema` | Permitir archivos OpenAPI alojados localmente servidos por HTTP. |
@@ -608,7 +608,7 @@ mint validate [flags]
 
 | Flag | Descripción |
 | --- | --- |
-| `--groups` | Lista separada por comas de grupos de usuarios a simular para la validación. |
+| `--groups` | Lista separada por espacios de grupos de usuarios a simular para la validación. Por ejemplo, `--groups admin user`. |
 | `--disable-openapi` | Omitir el procesamiento y validación de archivos OpenAPI. |
 | `--local-schema` | Permitir la validación de archivos OpenAPI alojados localmente servidos por HTTP. Solo admite HTTPS en producción. |
 
@@ -684,7 +684,7 @@ mint export [flags]
 | Flag | Descripción |
 | --- | --- |
 | `--output` | Nombre del archivo de salida. Por defecto `export.zip`. |
-| `--groups` | Lista separada por comas de grupos de usuarios para incluir páginas restringidas. |
+| `--groups` | Lista separada por espacios de grupos de usuarios para incluir páginas restringidas. Por ejemplo, `--groups admin user`. |
 | `--disable-openapi` | Omitir el procesamiento de OpenAPI. |
 
 Consulta [Exportación offline](/es/deploy/export) para más detalles.

diff --git a/es/editor/settings.mdx b/es/editor/settings.mdx
@@ -8,7 +8,7 @@ keywords: ["editor", "settings", "ai", "instructions", "publishing", "pull reque
 La [página de configuración](https://app.mintlify.com/settings/deployment/editor) del editor controla la apariencia, el comportamiento de publicación y el comportamiento del agente.
 
 - **Appearance**: Preferencias personales sobre cómo se ve y se comporta el editor. Se aplican solo a usted.
-- **Publishing**: Valores predeterminados de todo el deployment sobre cómo el editor confirma cambios y abre pull requests. Se aplican a todas las personas que publican.
+- **Publishing**: Valores predeterminados de todo el deployment sobre cómo el editor confirma cambios y abre pull requests. Se aplican a todas las personas que publican. Cambiarlos requiere permiso para actualizar el deployment. Si los controles están deshabilitados para usted, contacte a un administrador.
 - **Chat**: Instrucciones persistentes para el agente de IA del editor.
 - **Danger zone**: Acciones que no se pueden deshacer.
 
@@ -68,9 +68,9 @@ Los autocommits en la branch main envían los cambios a su branch main automáti
 
 </div>
 
-Cuando este ajuste está activado, las pull requests nuevas creadas desde el editor se abren como borradores. No puede hacer merge de una pull request en borrador hasta que la marque como lista para revisión. Está activado de forma predeterminada.
+Cuando este ajuste está activado, las pull requests creadas desde el editor se abren como borradores. Los autores las marcan como listas para revisión cuando terminan de editar. Este ajuste está activado de forma predeterminada.
 
-Las pull requests en borrador son útiles cuando su equipo requiere una revisión manual antes de abrir una pull request para su aprobación, o cuando quiere compartir URLs de vista previa sin dar a entender que el cambio está listo para hacer merge.
+Desactívelo si quiere que las pull requests del editor se abran listas para revisión de inmediato.
 
 <div id="pr-merge-method">
 

diff --git a/es/guides/branches.mdx b/es/guides/branches.mdx
@@ -87,7 +87,7 @@ Usa nombres claros y descriptivos que indiquen el propósito de un branch.
 
 <Tabs>
   <Tab title="Usar el editor web">
-    Selecciona el botón **Save as commit** en la parte superior derecha de la barra de herramientas del editor. Esto crea una confirmación y sube tu trabajo a tu branch automáticamente.
+    Selecciona el botón **Save in branch** en la parte superior derecha de la barra de herramientas del editor. Esto crea una confirmación y sube tu trabajo a tu branch automáticamente.
   </Tab>
 
   <Tab title="Usar desarrollo local">
@@ -138,4 +138,20 @@ Usa nombres claros y descriptivos que indiquen el propósito de un branch.
   ## Fusionar branches
 </div>
 
-Cuando tus cambios estén listos para su publicación, crea una solicitud de extracción para fusionar tu branch en la rama de implementación. 
+Cuando tus cambios estén listos para su publicación, fusiona tu branch en la rama de implementación.
+
+<Tabs>
+  <Tab title="Usar el editor web">
+    Si Mintlify aloja tu repositorio, haz clic en **Merge and publish** para fusionar tu branch y publicar tus cambios.
+
+    Si conectaste tu propio repositorio de Git:
+
+    1. Haz clic en **Create pull request** en la parte superior derecha de la barra de herramientas del editor. El editor abre una solicitud de extracción dirigida a tu rama de implementación.
+    1. En tu proveedor de Git, marca la solicitud de extracción como lista para revisión si es un borrador. Completa las revisiones y comprobaciones requeridas y, a continuación, fusiónala.
+
+    Consulta [Publicar cambios](/es/editor/publish) para saber cómo cambian las acciones de publicación disponibles según tu branch y las protecciones de branch.
+  </Tab>
+  <Tab title="Usar desarrollo local">
+    Sube tu branch y luego abre una solicitud de extracción en tu proveedor de Git dirigida a tu rama de implementación. Después de que la solicitud de extracción se fusione, Mintlify compila y despliega tus cambios en tu sitio en producción.
+  </Tab>
+</Tabs>
diff --git a/fr/ai/bring-your-own-model.mdx b/fr/ai/bring-your-own-model.mdx
@@ -1,6 +1,6 @@
 ---
 title: "Utiliser votre propre modèle"
-description: "Utilisez votre propre clé d'API de fournisseur LLM et choisissez le modèle qui alimente l'assistant, l'agent et les automatisations Mintlify sur les forfaits Enterprise."
+description: "Utilisez votre propre clé d'API LLM et choisissez le modèle qui alimente l'assistant, l'agent et les automatisations Mintlify sur les forfaits Enterprise."
 keywords: ["BYOK", "clé", "OpenRouter", "Anthropic", "OpenAI", "LLM", "clé d'API", "crédits"]
 ---
 
@@ -21,8 +21,10 @@ L'utilisation de votre propre modèle s'applique à un seul déploiement, pas à
 | Fournisseur | Couverture |
 |:---------|:---------|
 | OpenRouter | Complète. Tous les produits d'IA utilisent votre clé et votre modèle. |
-| Anthropic | Limitée. Certains produits d'IA continuent d'utiliser les modèles de Mintlify. |
-| Compatible OpenAI | Limitée. Certains produits d'IA continuent d'utiliser les modèles de Mintlify. |
+| Anthropic | Limitée. L'assistant utilise votre clé. L'agent et les automatisations continuent d'utiliser les modèles de Mintlify. |
+| Compatible OpenAI | Limitée. L'assistant utilise votre clé. L'agent et les automatisations continuent d'utiliser les modèles de Mintlify. |
+
+Pour exécuter tous les produits d'IA avec votre propre clé, utilisez OpenRouter.
 
 Chaque fournisseur prend en charge un ensemble fixe de modèles.
 

diff --git a/fr/cli/commands.mdx b/fr/cli/commands.mdx
@@ -34,7 +34,7 @@ mint dev [flags]
 | --- | --- |
 | `--port` | Port pour la prévisualisation locale. Par défaut `3000`. |
 | `--no-open` | Ne pas ouvrir le navigateur automatiquement. |
-| `--groups` | Liste séparée par des virgules de groupes d'utilisateurs à simuler pour la prévisualisation. |
+| `--groups` | Liste séparée par des espaces de groupes d'utilisateurs à simuler pour la prévisualisation. Par exemple, `--groups admin user`. |
 | `--disable-openapi` | Ignorer le traitement des fichiers OpenAPI pour améliorer les performances. |
 | `--disable-prefetch` | Désactiver le préchargement de la navigation dans la prévisualisation locale. Utile pour les très grands sites où le préchargement en arrière-plan ralentit le chargement des pages. |
 | `--local-schema` | Autoriser les fichiers OpenAPI hébergés localement servis via HTTP. |
@@ -610,7 +610,7 @@ mint validate [flags]
 
 | Flag | Description |
 | --- | --- |
-| `--groups` | Liste séparée par des virgules de groupes d'utilisateurs à simuler pour la validation. |
+| `--groups` | Liste séparée par des espaces de groupes d'utilisateurs à simuler pour la validation. Par exemple, `--groups admin user`. |
 | `--disable-openapi` | Ignorer le traitement et la validation des fichiers OpenAPI. |
 | `--local-schema` | Autoriser la validation des fichiers OpenAPI hébergés localement servis via HTTP. Ne prend en charge que HTTPS en production. |
 
@@ -686,7 +686,7 @@ mint export [flags]
 | Flag | Description |
 | --- | --- |
 | `--output` | Nom du fichier de sortie. Par défaut `export.zip`. |
-| `--groups` | Liste séparée par des virgules de groupes d'utilisateurs pour inclure les pages restreintes. |
+| `--groups` | Liste séparée par des espaces de groupes d'utilisateurs pour inclure les pages restreintes. Par exemple, `--groups admin user`. |
 | `--disable-openapi` | Ignorer le traitement OpenAPI. |
 
 Consultez [Export hors ligne](/fr/deploy/export) pour plus de détails.

diff --git a/fr/editor/settings.mdx b/fr/editor/settings.mdx
@@ -8,7 +8,7 @@ keywords: ["editor", "settings", "ai", "instructions", "publishing", "pull reque
 La [page de paramètres](https://app.mintlify.com/settings/deployment/editor) de l'éditeur contrôle l'apparence, le comportement de publication et le comportement de l'agent.
 
 - **Appearance** : Préférences personnelles sur l'aspect et le comportement de l'éditeur. Elles ne s'appliquent qu'à vous.
-- **Publishing** : Valeurs par défaut, à l'échelle du deployment, sur la façon dont l'éditeur commit les modifications et ouvre les pull requests. Elles s'appliquent à toutes les personnes qui publient.
+- **Publishing** : Valeurs par défaut, à l'échelle du deployment, sur la façon dont l'éditeur commit les modifications et ouvre les pull requests. Elles s'appliquent à toutes les personnes qui publient. Leur modification nécessite l'autorisation de mettre à jour le deployment. Si les contrôles sont désactivés pour vous, contactez un admin.
 - **Chat** : Instructions persistantes pour l'agent d'IA de l'éditeur.
 - **Danger zone** : Actions irréversibles.
 
@@ -68,9 +68,9 @@ Les autocommits sur la branch main poussent vos modifications vers votre branch
 
 </div>
 
-Lorsque ce paramètre est activé, les nouvelles pull requests créées depuis l'éditeur s'ouvrent en brouillon. Vous ne pouvez pas fusionner une pull request en brouillon tant que vous ne l'avez pas marquée comme prête à être relue. Ce paramètre est activé par défaut.
+Lorsque ce paramètre est activé, les pull requests créées depuis l'éditeur s'ouvrent en brouillon. Les auteurs les marquent comme prêtes à être relues lorsqu'ils ont terminé leurs modifications. Ce paramètre est activé par défaut.
 
-Les pull requests en brouillon sont utiles lorsque votre équipe exige une relecture manuelle avant d'ouvrir une pull request à l'approbation, ou lorsque vous voulez partager des URLs de prévisualisation sans laisser entendre que la modification est prête à être fusionnée.
+Désactivez-le si vous voulez que les pull requests de l'éditeur s'ouvrent immédiatement prêtes à être relues.
 
 <div id="pr-merge-method">
 

diff --git a/fr/guides/branches.mdx b/fr/guides/branches.mdx
@@ -87,7 +87,7 @@ Utilisez des noms explicites et descriptifs qui indiquent clairement l’objecti
 
 <Tabs>
   <Tab title="Avec l'éditeur web">
-    Cliquez sur le bouton **Save as commit** dans le coin supérieur droit de la barre d'outils de l'éditeur. Cela crée un commit et envoie automatiquement votre travail sur votre branche.
+    Cliquez sur le bouton **Save in branch** dans le coin supérieur droit de la barre d'outils de l'éditeur. Cela crée un commit et envoie automatiquement votre travail sur votre branche.
   </Tab>
   <Tab title="Avec un environnement de développement local">
     Préparez, validez, puis poussez vos modifications.
@@ -137,4 +137,20 @@ Utilisez des noms explicites et descriptifs qui indiquent clairement l’objecti
   ## Fusionner des branches
 </div>
 
-Une fois que vos modifications sont prêtes à être publiées, créez une pull request (demande de fusion) pour fusionner votre branche dans la branche de déploiement. 
+Une fois que vos modifications sont prêtes à être publiées, fusionnez votre branche dans la branche de déploiement.
+
+<Tabs>
+  <Tab title="Avec l’éditeur web">
+    Si Mintlify héberge votre dépôt, cliquez sur **Merge and publish** pour fusionner votre branche et publier vos modifications.
+
+    Si vous avez connecté votre propre dépôt Git :
+
+    1. Cliquez sur **Create pull request** dans le coin supérieur droit de la barre d’outils de l’éditeur. L’éditeur ouvre une pull request qui cible votre branche de déploiement.
+    1. Dans votre fournisseur Git, marquez la pull request comme prête à être relue si elle est en brouillon. Effectuez les relectures et vérifications requises, puis fusionnez-la.
+
+    Consultez [Publier vos modifications](/fr/editor/publish) pour savoir comment les actions de publication disponibles changent en fonction de votre branche et des protections de branche.
+  </Tab>
+  <Tab title="Avec un environnement de développement local">
+    Poussez votre branche, puis ouvrez une pull request dans votre fournisseur Git qui cible votre branche de déploiement. Une fois la pull request fusionnée, Mintlify génère et déploie vos modifications sur votre site en ligne.
+  </Tab>
+</Tabs>