From a7af89e24b1b831720f4fc78cb7cabba7af8e3a4 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 21 May 2026 15:12:09 +0000 Subject: [PATCH 1/2] docs: fix Vale warnings in pages updated last week --- editor/settings.mdx | 8 ++++---- organize/settings-reference.mdx | 4 ++-- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/editor/settings.mdx b/editor/settings.mdx index 2ca7e515d..45b38dfad 100644 --- a/editor/settings.mdx +++ b/editor/settings.mdx @@ -7,7 +7,7 @@ keywords: ["editor", "settings", "ai", "instructions", "publishing", "pull reque The web editor has two layers of settings: - **Your settings** apply only to you and control how the editor's AI assists with your edits. -- **Publishing settings** apply to everyone on a deployment and shape what happens when changes are committed and turned into pull requests. +- **Publishing settings** apply to everyone on a deployment and shape what happens when you commit changes and turn them into pull requests. You can configure both from the **Settings** menu in the editor. @@ -20,7 +20,7 @@ Your instructions apply to: - **Edit with AI** actions on a selection, such as rewrite, expand, or fix. - **Agent sessions** started from the editor. -Instructions are scoped to your user account, so each teammate maintains their own. +Each teammate maintains their own instructions, scoped to their user account. ### When to use AI instructions @@ -54,7 +54,7 @@ Leave the field empty to remove your instructions. ## Publishing settings -Publishing settings are configured per deployment and apply to everyone who publishes from the editor. They control how pull requests and commits are generated, opened, and merged. +You configure publishing settings per deployment, and they apply to everyone who publishes from the editor. They control how the editor generates, opens, and merges pull requests and commits. You need admin access to your Mintlify deployment to change publishing settings. @@ -114,7 +114,7 @@ Choose how the editor merges pull requests when you click **Merge and publish**: - **Squash**: Combines all commits in the branch into a single commit on your deployment branch. - **Rebase**: Replays each commit from the branch onto your deployment branch without a merge commit. -The selected method is used by default. If you pass an explicit merge method through the API or your Git provider's UI, that choice takes precedence. +The editor uses the selected method by default. If you pass an explicit merge method through the API or your Git provider's UI, that choice takes precedence. Match your default merge method to your Git provider's branch protection settings. If your deployment branch only allows squash merges, set the default to **Squash** to avoid failed merges from the editor. diff --git a/organize/settings-reference.mdx b/organize/settings-reference.mdx index 36fa3b5bb..705b59829 100644 --- a/organize/settings-reference.mdx +++ b/organize/settings-reference.mdx @@ -242,7 +242,7 @@ Individual pages in your documentation. #### `navigation.directory` -Directory layout for root pages in navigation groups. Inherits recursively; descendants can override. See [Directory listings](/organize/navigation#directory-listings). +Directory layout for root pages in navigation groups. Inherits recursively. Descendants can override. See [Directory listings](/organize/navigation#directory-listings). **Type:** `"none"` | `"accordion"` | `"card"` — default `"none"` @@ -794,7 +794,7 @@ Whether to expand all parameters by default. ##### `api.params.post` -OpenAPI spec field keys to surface as post pills next to every parameter name. For each key, Mintlify reads the value on the schema and renders it as a pill: strings render verbatim, `true` renders the key name, numbers stringify, and arrays render one pill per element. `false`, `null`, empty strings, and objects are skipped. +OpenAPI spec field keys to surface as post pills next to every parameter name. For each key, Mintlify reads the value on the schema and renders it as a pill: strings render verbatim, `true` renders the key name, numbers stringify, and arrays render one pill per element. Mintlify skips `false`, `null`, empty strings, and objects. **Type:** array of string From dd4dfa1497d0ec3550fd0a421a57a867c45c24b8 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 21 May 2026 15:16:45 +0000 Subject: [PATCH 2/2] docs: mirror Vale fixes into es and fr translations --- es/editor/settings.mdx | 8 ++++---- es/organize/settings-reference.mdx | 4 ++-- fr/editor/settings.mdx | 8 ++++---- fr/organize/settings-reference.mdx | 4 ++-- 4 files changed, 12 insertions(+), 12 deletions(-) diff --git a/es/editor/settings.mdx b/es/editor/settings.mdx index bfc0a2c42..7fdec1022 100644 --- a/es/editor/settings.mdx +++ b/es/editor/settings.mdx @@ -7,7 +7,7 @@ keywords: ["editor", "configuración", "ai", "instrucciones", "publicación", "p El editor web tiene dos capas de configuración: - **Tu configuración** se aplica solo a ti y controla cómo la IA del editor te ayuda con tus ediciones. -- **La configuración de publicación** se aplica a todos los miembros de un deployment y determina qué sucede cuando los cambios se confirman y se convierten en pull requests. +- **La configuración de publicación** se aplica a todos los miembros de un deployment y determina qué sucede cuando confirmas cambios y los conviertes en pull requests. Puedes configurar ambas desde el menú **Settings** en el editor. @@ -22,7 +22,7 @@ Tus instrucciones se aplican a: - Acciones **Edit with AI** sobre una selección, como reescribir, ampliar o corregir. - **Sesiones del agente** iniciadas desde el editor. -Las instrucciones están asociadas a tu cuenta de usuario, por lo que cada compañero de equipo mantiene las suyas. +Cada compañero de equipo mantiene sus propias instrucciones, asociadas a su cuenta de usuario.
### Cuándo usar las instrucciones de IA @@ -62,7 +62,7 @@ Deja el campo vacío para eliminar tus instrucciones. ## Configuración de publicación
-La configuración de publicación se establece por deployment y se aplica a todas las personas que publican desde el editor. Controla cómo se generan, se abren y se fusionan los pull requests y los commits. +La configuración de publicación se establece por deployment y se aplica a todas las personas que publican desde el editor. Controla cómo el editor genera, abre y fusiona los pull requests y los commits. Necesitas acceso de administrador a tu deployment de Mintlify para cambiar la configuración de publicación. @@ -130,7 +130,7 @@ Elige cómo fusiona el editor los pull requests cuando haces clic en **Merge and - **Squash**: Combina todos los commits de la rama en un único commit en tu rama de deployment. - **Rebase**: Reproduce cada commit de la rama sobre tu rama de deployment sin crear un commit de fusión. -El método seleccionado se usa por defecto. Si pasas un método de fusión explícito a través de la API o de la interfaz de tu proveedor de Git, esa elección tiene prioridad. +El editor usa el método seleccionado por defecto. Si pasas un método de fusión explícito a través de la API o de la interfaz de tu proveedor de Git, esa elección tiene prioridad. Ajusta tu método de fusión predeterminado a las reglas de protección de ramas de tu proveedor de Git. Si tu rama de deployment solo permite fusiones tipo squash, configura el valor predeterminado en **Squash** para evitar fusiones fallidas desde el editor. diff --git a/es/organize/settings-reference.mdx b/es/organize/settings-reference.mdx index cf548161b..2065658ff 100644 --- a/es/organize/settings-reference.mdx +++ b/es/organize/settings-reference.mdx @@ -244,7 +244,7 @@ Páginas individuales en tu documentación. #### `navigation.directory` -Diseño de directorio para páginas raíz en grupos de navegación. Se hereda recursivamente; los descendientes pueden sobreescribirlo. Consulta [Listados de directorio](/es/organize/navigation#directory-listings). +Diseño de directorio para páginas raíz en grupos de navegación. Se hereda recursivamente. Los descendientes pueden sobreescribirlo. Consulta [Listados de directorio](/es/organize/navigation#directory-listings). **Tipo:** `"none"` | `"accordion"` | `"card"` — predeterminado `"none"` @@ -796,7 +796,7 @@ Si se expanden todos los parámetros de forma predeterminada. ##### `api.params.post` -Claves de campos de la especificación OpenAPI que se mostrarán como píldoras post junto al nombre de cada parámetro. Para cada clave, Mintlify lee el valor del esquema y lo renderiza como una píldora: las cadenas se renderizan literalmente, `true` renderiza el nombre de la clave, los números se convierten en cadena y los arreglos renderizan una píldora por elemento. Los valores `false`, `null`, las cadenas vacías y los objetos se omiten. +Claves de campos de la especificación OpenAPI que se mostrarán como píldoras post junto al nombre de cada parámetro. Para cada clave, Mintlify lee el valor del esquema y lo renderiza como una píldora: las cadenas se renderizan literalmente, `true` renderiza el nombre de la clave, los números se convierten en cadena y los arreglos renderizan una píldora por elemento. Mintlify omite los valores `false`, `null`, las cadenas vacías y los objetos. **Tipo:** array of string diff --git a/fr/editor/settings.mdx b/fr/editor/settings.mdx index 3de26848b..d3c1175ab 100644 --- a/fr/editor/settings.mdx +++ b/fr/editor/settings.mdx @@ -7,7 +7,7 @@ keywords: ["éditeur", "paramètres", "ai", "instructions", "publication", "pull L'éditeur web comporte deux niveaux de paramètres : - **Vos paramètres** ne s'appliquent qu'à vous et contrôlent la façon dont l'IA de l'éditeur vous assiste pendant vos modifications. -- **Les paramètres de publication** s'appliquent à toutes les personnes d'un déploiement et déterminent ce qui se passe lorsque les modifications sont committées puis transformées en pull requests. +- **Les paramètres de publication** s'appliquent à toutes les personnes d'un déploiement et déterminent ce qui se passe lorsque vous committez des modifications et les transformez en pull requests. Vous pouvez configurer les deux depuis le menu **Settings** de l'éditeur. @@ -22,7 +22,7 @@ Vos instructions s'appliquent à : - Les actions **Edit with AI** sur une sélection, comme réécrire, développer ou corriger. - Les **sessions de l'agent** lancées depuis l'éditeur. -Les instructions sont liées à votre compte utilisateur, donc chaque membre de l'équipe gère les siennes. +Chaque membre de l'équipe gère ses propres instructions, liées à son compte utilisateur.
### Quand utiliser les instructions d'IA @@ -62,7 +62,7 @@ Laissez le champ vide pour supprimer vos instructions. ## Paramètres de publication
-Les paramètres de publication se configurent par déploiement et s'appliquent à toutes les personnes qui publient depuis l'éditeur. Ils contrôlent la façon dont les pull requests et les commits sont générés, ouverts et fusionnés. +Vous configurez les paramètres de publication par déploiement, et ils s'appliquent à toutes les personnes qui publient depuis l'éditeur. Ils contrôlent la façon dont l'éditeur génère, ouvre et fusionne les pull requests et les commits. Vous devez disposer d'un accès administrateur à votre déploiement Mintlify pour modifier les paramètres de publication. @@ -130,7 +130,7 @@ Choisissez la manière dont l'éditeur fusionne les pull requests lorsque vous c - **Squash** : Combine tous les commits de la branche en un seul commit sur votre branche de déploiement. - **Rebase** : Rejoue chaque commit de la branche sur votre branche de déploiement, sans commit de fusion. -La méthode sélectionnée est utilisée par défaut. Si vous passez une méthode de fusion explicite via l'API ou l'interface de votre fournisseur Git, ce choix prévaut. +L'éditeur utilise la méthode sélectionnée par défaut. Si vous passez une méthode de fusion explicite via l'API ou l'interface de votre fournisseur Git, ce choix prévaut. Alignez votre méthode de fusion par défaut sur les règles de protection de branche de votre fournisseur Git. Si votre branche de déploiement n'autorise que les fusions squash, définissez la valeur par défaut sur **Squash** pour éviter les échecs de fusion depuis l'éditeur. diff --git a/fr/organize/settings-reference.mdx b/fr/organize/settings-reference.mdx index 7119eaf46..696852f91 100644 --- a/fr/organize/settings-reference.mdx +++ b/fr/organize/settings-reference.mdx @@ -244,7 +244,7 @@ Pages individuelles de votre documentation. #### `navigation.directory` -Disposition de répertoire pour les pages racines dans les groupes de navigation. S'hérite récursivement ; les descendants peuvent remplacer cette valeur. Voir [Listes de répertoire](/fr/organize/navigation#directory-listings). +Disposition de répertoire pour les pages racines dans les groupes de navigation. S'hérite récursivement. Les descendants peuvent remplacer cette valeur. Voir [Listes de répertoire](/fr/organize/navigation#directory-listings). **Type :** `"none"` | `"accordion"` | `"card"` — par défaut `"none"` @@ -796,7 +796,7 @@ Indique s'il faut développer tous les paramètres par défaut. ##### `api.params.post` -Clés de champs de la spécification OpenAPI à faire apparaître sous forme de pastilles post à côté du nom de chaque paramètre. Pour chaque clé, Mintlify lit la valeur sur le schéma et l'affiche sous forme de pastille : les chaînes s'affichent telles quelles, `true` affiche le nom de la clé, les nombres sont convertis en chaîne, et les tableaux affichent une pastille par élément. `false`, `null`, les chaînes vides et les objets sont ignorés. +Clés de champs de la spécification OpenAPI à faire apparaître sous forme de pastilles post à côté du nom de chaque paramètre. Pour chaque clé, Mintlify lit la valeur sur le schéma et l'affiche sous forme de pastille : les chaînes s'affichent telles quelles, `true` affiche le nom de la clé, les nombres sont convertis en chaîne, et les tableaux affichent une pastille par élément. Mintlify ignore `false`, `null`, les chaînes vides et les objets. **Type :** array of string