mintlify · locadex-agent · Feb 27, 2026
diff --git a/es/api-playground/troubleshooting.mdx b/es/api-playground/troubleshooting.mdx
@@ -62,15 +62,16 @@ Si sus páginas de la API no se muestran correctamente, revise estos problemas d
   </Accordion>
 
   <Accordion title="Las solicitudes del área de pruebas de la API no funcionan">
-    Si tienes un domain personalizado configurado, esto podría deberse a un problema con tu proxy inverso. De forma predeterminada, las solicitudes realizadas a través del área de pruebas de la API comienzan con una solicitud `POST` a la
+    Si tienes un domain personalizado configurado, esto podría deberse a un problema con tu proxy inverso. De forma predeterminada,
+    las solicitudes realizadas a través del área de pruebas de la API comienzan con una solicitud `POST` a la
     ruta `/_mintlify/api/request` en el sitio de documentación. Si tu proxy inverso está configurado para permitir únicamente solicitudes `GET`
     entonces todas estas solicitudes fallarán. Para solucionarlo, configura tu proxy inverso para
     permitir solicitudes `POST` a la ruta `/_mintlify/api/request`.
 
     Como alternativa, si tu proxy inverso impide aceptar solicitudes `POST`, puedes configurar Mintlify para enviar solicitudes directamente a tu backend con el ajuste `api.playground.proxy` en el `docs.json`, como se describe en la [documentación de configuración](/es/organize/settings#param-proxy). Al usar esta configuración, deberás configurar CORS en tu servidor, ya que las solicitudes llegarán directamente desde los navegadores de los usuarios en lugar de pasar por tu proxy.
   </Accordion>
 
-  <Accordion title="Las entradas de navigation de OpenAPI no están generando páginas">
+  <Accordion title="Las entradas de navigation de OpenAPI no generan páginas">
     Si usas una configuración de navigation de OpenAPI, pero las páginas no se generan, revisa estos problemas comunes:
 
     1. **Falta la especificación de OpenAPI predeterminada**: Asegúrate de tener definido un campo `openapi` en el elemento de navigation:
@@ -98,14 +99,14 @@ Si sus páginas de la API no se muestran correctamente, revise estos problemas d
   <Accordion title="Algunas operaciones de OpenAPI aparecen en navigation, pero otras no">
     1. **Operaciones ocultas**: Las operaciones marcadas con `x-hidden: true` en tu especificación de OpenAPI no aparecerán en la navigation generada automáticamente.
     2. **Operaciones no válidas**: Las operaciones con errores de validación en la especificación de OpenAPI pueden omitirse. Revisa tu documento de OpenAPI para detectar errores de sintaxis.
-    3. **Inclusión manual vs. automática**: Si haces referencia a endpoints de una especificación de OpenAPI, solo las operaciones referenciadas explícitamente aparecerán en la navigation. No se agregarán otras páginas automáticamente. Esto incluye operaciones referenciadas en elementos secundarios de la navigation.
+    3. **Inclusión manual vs. automática**: Si haces referencia a endpoints de una especificación de OpenAPI, solo las operaciones referenciadas explícitamente aparecen en la navigation. No se agregan otras páginas automáticamente. Esto incluye operaciones referenciadas en elementos secundarios de la navigation.
   </Accordion>
 
   <Accordion title="La navigation combinada (páginas de OpenAPI y MDX) no funciona correctamente">
     Al combinar operaciones de OpenAPI con páginas de documentación estándar en navigation:
 
     1. **Conflictos de archivos**: No puedes tener a la vez un archivo `MDX` y una entrada en navigation para la misma operación. Por ejemplo, si tienes `get-users.mdx`, no incluyas también `"GET /users"` en tu navigation. Si necesitas un archivo que comparta nombre con una operación, usa la extensión `x-mint` del endpoint para que el href apunte a otra ubicación.
-    2. **Resolución de rutas**: Las entradas en navigation que no coincidan con operaciones de OpenAPI se tratarán como rutas de archivo. Asegúrate de que tus archivos `MDX` existan en las ubicaciones esperadas.
-    3. **Distinción entre mayúsculas y minúsculas**: La coincidencia de operaciones de OpenAPI distingue mayúsculas y minúsculas. Asegúrate de que los métodos HTTP estén en mayúsculas en las entradas de navigation.
+    2. **Resolución de rutas**: Las entradas en navigation que no coincidan con operaciones de OpenAPI se tratan como rutas de archivo. Asegúrate de que tus archivos `MDX` existan en las ubicaciones esperadas.
+    3. **Distinción entre mayúsculas y minúscculas**: La coincidencia de operaciones de OpenAPI distingue mayúsculas y minúsculas. Asegúrate de que los métodos HTTP estén en mayúsculas en las entradas de navigation.
   </Accordion>
 </AccordionGroup>
diff --git a/es/components/mermaid-diagrams.mdx b/es/components/mermaid-diagrams.mdx
@@ -48,13 +48,14 @@ Para ver la lista completa de tipos de diagramas compatibles y su sintaxis, cons
 ```
 ````
 
+
 <div id="elk-layout-support">
-  ## Compatibilidad con diseño ELK
+  ## Compatibilidad con el diseño ELK
 </div>
 
-Mintlify es compatible con el motor de diseño [ELK (Eclipse Layout Kernel)](https://www.eclipse.org/elk/) para diagramas de Mermaid. ELK optimiza la disposición para reducir superposiciones y mejorar la legibilidad, lo cual es útil para diagramas grandes o complejos.
+Mintlify es compatible con el motor de diseño [ELK (Eclipse Layout Kernel)](https://www.eclipse.org/elk/) para diagramas Mermaid. ELK optimiza la disposición para reducir solapamientos y mejorar la legibilidad, lo cual es especialmente útil para diagramas grandes o complejos.
 
-Para usar el diseño ELK en tus diagramas de Mermaid, agrega la directiva `%%{init: {'flowchart': {'defaultRenderer': 'elk'}}}%%` al comienzo de tu diagrama:
+Para utilizar el diseño ELK en tus diagramas Mermaid, añade la directiva `%%{init: {'flowchart': {'defaultRenderer': 'elk'}}}%%` al principio de tu diagrama:
 
 ````mdx ELK layout example
 ```mermaid
@@ -68,6 +69,7 @@ flowchart LR
 ```
 ````
 
+
 <div id="interactive-controls">
   ## Controles interactivos
 </div>

diff --git a/es/customize/custom-404-page.mdx b/es/customize/custom-404-page.mdx
@@ -42,5 +42,5 @@ Configura la página 404 en la sección `errors.404` de tu archivo `docs.json`:
 </ResponseField>
 
 <ResponseField name="description" type="string">
-  Descripción personalizada para la página de error 404. Admite formato Markdown.
+  Descripción personalizada para la página de error 404. Admite formato MDX, incluidos enlaces, texto en negrita y en cursiva, y componentes personalizados.
 </ResponseField>
diff --git a/es/deploy/ci.mdx b/es/deploy/ci.mdx
@@ -435,3 +435,9 @@ Este texto es ignorado por Vale
 ```
 
 Vale reconoce y respeta automáticamente estos comentarios en los archivos MDX sin necesidad de configuración adicional. Usa los comentarios para omitir líneas o secciones que el linter deba ignorar.
+
+<Warning>
+  No coloques `{/* vale off */}` o comentarios de expresión MDX similares como hijos directos de un componente JSX entre elementos hermanos. Por ejemplo, entre dos elementos `<Step>` dentro de un componente `<Steps>`.
+
+  Coloca los comentarios dentro del contenido de un elemento específico o reestructura el contenido para evitar la necesidad de comentarios.
+</Warning>
diff --git a/es/editor/keyboard-shortcuts.mdx b/es/editor/keyboard-shortcuts.mdx
@@ -69,9 +69,9 @@ Usa estos atajos de teclado al editar en modo visual.
   ### Sustituciones inteligentes
 </div>
 
-El editor convierte automáticamente ciertas secuencias de caracteres en símbolos tipográficos mientras escribes. El editor omite las sustituciones dentro de bloques de código y código en línea.
+El editor convierte automáticamente ciertas secuencias de caracteres en símbolos tipográficos a medida que escribes. El editor omite las sustituciones en los bloques de código y en el código en línea.
 
-| Escribe | Resultado |
+| Tipo | Resultado |
 | :--- | :--- |
 | `->` | → |
 | `<-` | ← |

diff --git a/es/guides/understand-your-audience.mdx b/es/guides/understand-your-audience.mdx
@@ -45,4 +45,4 @@ Hablar directamente con usuarios ayuda a anclar tu redacción en su perspectiva,
 2. **Incorpora mecanismos de retroalimentación.** Ya sea con pulgares arriba/abajo o campos de texto simples, ofrece a los usuarios la oportunidad de enviar comentarios mientras leen tu documentación.
 3. **Usa Analytics para guiarte.** Revisa los comentarios y las conclusiones para entender dónde tienen dificultades los usuarios y dónde tienen éxito. Actualiza la documentación con la que la gente tiene problemas o la más directamente relacionada con las tareas clave de tu producto.
 
-Siempre habrá casos extremos que no estén cubiertos por tu documentación. Prioriza las páginas de mayor impacto para ayudar al mayor número de personas. Un exceso de contenido se vuelve difícil de navegar y mantener, por lo que intentar documentar todos los escenarios posibles puede ser contraproducente.
+Los casos extremos que no están cubiertos por tu documentación siempre existen. Prioriza las páginas de mayor impacto para ayudar al mayor número de personas. Un exceso de contenido se vuelve difícil de navegar y mantener, por lo que intentar documentar todos los escenarios posibles puede ser contraproducente.
diff --git a/es/guides/windsurf.mdx b/es/guides/windsurf.mdx
@@ -15,7 +15,7 @@ El assistant Cascade de IA de Windsurf se puede ajustar para redactar documentac
 * **Reglas del espacio de trabajo**: se almacenan en tu repositorio de documentación y se comparten con tu equipo.
 * **Memorias**: proporcionan contexto individual que se acumula con el tiempo.
 
-Recomendamos configurar reglas del espacio de trabajo para unificar los estándares de documentación. Puedes desarrollar memorias a medida que trabajas, pero como no se comparten, no serán consistentes entre los miembros del equipo.
+Recomendamos configurar reglas del espacio de trabajo para unificar los estándares de documentación. Puedes desarrollar memorias a medida que trabajas, pero como no se comparten, no son consistentes entre los miembros del equipo.
 
 Crea reglas del espacio de trabajo en el directorio `.windsurf/rules` de tu repositorio de documentación. Consulta [Memories &amp; Rules](https://docs.windsurf.com/windsurf/cascade/memories) en la documentación de Windsurf para obtener más información.
 

diff --git a/es/installation.mdx b/es/installation.mdx
@@ -306,7 +306,7 @@ Si usas JetBrains, recomendamos el [plugin MDX para IntelliJ IDEA](https://plugi
   <Accordion title="Error: permiso denegado">
     Esto se debe a no tener los permisos necesarios para instalar paquetes de Node de forma global.
 
-    **Solución**: Intenta ejecutar `sudo npm i -g mint`. Se te pedirá tu contraseña, la misma que usas para desbloquear tu computadora.
+    **Solución**: Intenta ejecutar `sudo npm i -g mint`. Cuando se te solicite, introduce la contraseña que usas para desbloquear tu computadora.
   </Accordion>
 
   <Accordion title="La vista previa local no se ve igual que mi documentación en la web">

diff --git a/es/integrations/analytics/google-analytics.mdx b/es/integrations/analytics/google-analytics.mdx
@@ -46,7 +46,7 @@ Añade tu Measurement ID a tu archivo `docs.json` de la siguiente manera:
 
 Google Analytics tarda entre dos y tres días en mostrar tus datos.
 
-Puedes usar el [Google Analytics Debugger](https://chrome.google.com/webstore/detail/google-analytics-debugger/jnkmfdileelhofjcijamephohjechhna?hl=en) para comprobar que Analytics está habilitado correctamente. La extensión registrará en la consola de tu navegador cada vez que GA4 haga una solicitud.
+Puedes usar el [Google Analytics Debugger](https://chrome.google.com/webstore/detail/google-analytics-debugger/jnkmfdileelhofjcijamephohjechhna?hl=en) para comprobar tu configuración de Analytics. La extensión registra en la consola de tu navegador cada vez que GA4 hace una solicitud.
 
 <Note>
 

diff --git a/es/organize/settings.mdx b/es/organize/settings.mdx
@@ -927,10 +927,11 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
         </ResponseField>
       </Expandable>
     </ResponseField>
-    <ResponseField name="spec" type="object">
-      Configuraciones para la especificación OpenAPI.
 
-      <Expandable title="Spec">
+    <ResponseField name="especificación" type="object">
+      Configuración para la especificación OpenAPI.
+
+      <Expandable title="Especificación">
         <ResponseField name="download" type="boolean">
           Indica si se muestra un botón de descarga para la especificación OpenAPI en las páginas de referencia de la API. El valor predeterminado es `false`.
         </ResponseField>
@@ -1246,7 +1247,7 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
         </ResponseField>
 
         <ResponseField name="description" type="string">
-          Descripción personalizada para la página de error 404. Admite formato MDX básico, incluyendo enlaces, texto en negrita y en cursiva. No se admiten componentes personalizados.
+          Descripción personalizada para la página de error 404. Admite formato MDX, incluyendo enlaces, texto en negrita, en cursiva y componentes personalizados.
         </ResponseField>
       </Expandable>
     </ResponseField>

diff --git a/es/quickstart.mdx b/es/quickstart.mdx
@@ -161,7 +161,7 @@ Encuentra tu URL exacta en la página **Overview** de tu [Dashboard de Mintlify]
 </div>
 
 <Card title="Usar el editor web" icon="mouse-pointer-2" horizontal href="/es/editor/index">
-  Edita la documentación en tu navegador y obtén una vista previa de cómo se verán tus páginas al publicarlas.
+  Edita la documentación en tu navegador y obtén una vista previa de cómo se ven tus páginas al publicarlas.
 </Card>
 
 <Card title="Explorar comandos de la CLI" icon="terminal" horizontal href="/es/installation">

diff --git a/fr/api-playground/troubleshooting.mdx b/fr/api-playground/troubleshooting.mdx
@@ -60,7 +60,7 @@ Si vos pages API ne s’affichent pas correctement, consultez ces problèmes de
     ```
   </Accordion>
 
-  <Accordion title="Les requêtes depuis le bac à sable d’API ne fonctionnent pas">
+  <Accordion title="Les requêtes du bac à sable d’API ne fonctionnent pas">
     Si vous avez configuré un domain personnalisé, le problème peut venir de votre reverse proxy. Par défaut, les requêtes effectuées via le bac à sable d’API commencent par une requête `POST` vers le chemin `/_mintlify/api/request` sur le site de documentation. Si votre reverse proxy est configuré pour n’autoriser que les requêtes `GET`, alors toutes ces requêtes échouent. Pour corriger cela, configurez votre reverse proxy pour autoriser les requêtes `POST` vers le chemin `/_mintlify/api/request`.
 
     Sinon, si votre reverse proxy empêche l’acceptation des requêtes `POST`, vous pouvez configurer Mintlify pour envoyer les requêtes directement à votre backend avec le paramètre `api.playground.proxy` dans le `docs.json`, comme décrit dans la [documentation des paramètres](/fr/organize/settings#param-proxy). Avec cette configuration, vous devez configurer CORS sur votre serveur, car les requêtes proviennent directement des navigateurs des utilisateurs plutôt que de passer par votre proxy.
@@ -91,17 +91,17 @@ Si vos pages API ne s’affichent pas correctement, consultez ces problèmes de
     3. **Problèmes de validation** : Utilisez `mint openapi-check <path-to-openapi-file>` pour vérifier que votre document OpenAPI est valide.
   </Accordion>
 
-  <Accordion title="Certaines opérations OpenAPI apparaissent dans la navigation, mais pas les autres">
+  <Accordion title="Certaines opérations OpenAPI apparaissent dans la navigation, mais d’autres non">
     1. **Opérations masquées** : Les opérations marquées `x-hidden: true` dans votre spécification OpenAPI n’apparaîtront pas dans la navigation générée automatiquement.
     2. **Opérations invalides** : Les opérations comportant des erreurs de validation dans la spécification OpenAPI peuvent être ignorées. Vérifiez votre document OpenAPI pour détecter les erreurs de syntaxe.
     3. **Inclusion manuelle vs automatique** : Si vous faites référence à des endpoints depuis une spécification OpenAPI, seules les opérations explicitement référencées apparaîtront dans la navigation. Aucune autre page ne sera ajoutée automatiquement. Cela inclut les opérations référencées dans des éléments enfants de la navigation.
   </Accordion>
 
   <Accordion title="La navigation mixte (pages OpenAPI et MDX) ne fonctionne pas correctement">
-    Lorsqu’on combine des opérations OpenAPI avec des pages de documentation classiques dans navigation :
+    Lorsqu’on combine des opérations OpenAPI avec des pages de documentation classiques dans navigation :
 
     1. **Conflits de fichiers** : Vous ne pouvez pas avoir à la fois un fichier `MDX` et une entrée de navigation pour la même opération. Par exemple, si vous avez `get-users.mdx`, n’incluez pas aussi &quot;GET /users&quot; dans votre navigation. Si vous devez avoir un fichier qui partage un nom avec une opération, utilisez l’extension `x-mint` pour le point de terminaison afin que le href pointe vers un autre emplacement.
-    2. **Résolution des chemins** : Les entrées de navigation qui ne correspondent pas aux opérations OpenAPI seront traitées comme des chemins de fichiers. Assurez-vous que vos fichiers `MDX` existent aux emplacements attendus.
+    2. **Résolution des chemins** : Les entrées de navigation qui ne correspondent pas aux opérations OpenAPI sont traitées comme des chemins de fichiers. Assurez-vous que vos fichiers `MDX` existent aux emplacements attendus.
     3. **Sensibilité à la casse** : La correspondance des opérations OpenAPI est sensible à la casse. Assurez-vous que les méthodes HTTP sont en majuscules dans les entrées de navigation.
   </Accordion>
 </AccordionGroup>
diff --git a/fr/components/mermaid-diagrams.mdx b/fr/components/mermaid-diagrams.mdx
@@ -48,13 +48,14 @@ Pour la liste complète des types de diagrammes pris en charge et de leur syntax
 ```
 ````
 
+
 <div id="elk-layout-support">
-  ## Prise en charge de la mise en page ELK
+  ## Prise en charge de la disposition ELK
 </div>
 
-Mintlify prend en charge le moteur de mise en page [ELK (Eclipse Layout Kernel)](https://www.eclipse.org/elk/) pour les diagrammes Mermaid. ELK optimise la disposition pour réduire les chevauchements et améliorer la lisibilité, ce qui est utile pour les diagrammes volumineux ou complexes.
+Mintlify prend en charge le moteur de disposition [ELK (Eclipse Layout Kernel)](https://www.eclipse.org/elk/) pour les diagrammes Mermaid. ELK optimise l’agencement afin de réduire les chevauchements et d’améliorer la lisibilité, ce qui est particulièrement utile pour les diagrammes de grande taille ou complexes.
 
-Pour utiliser la mise en page ELK dans vos diagrammes Mermaid, ajoutez la directive `%%{init: {'flowchart': {'defaultRenderer': 'elk'}}}%%` au début de votre diagramme :
+Pour utiliser la disposition ELK dans vos diagrammes Mermaid, ajoutez la directive `%%{init: {'flowchart': {'defaultRenderer': 'elk'}}}%%` au début de votre diagramme :
 
 ````mdx ELK layout example
 ```mermaid
@@ -68,6 +69,7 @@ flowchart LR
 ```
 ````
 
+
 <div id="interactive-controls">
   ## Contrôles interactifs
 </div>

diff --git a/fr/customize/custom-404-page.mdx b/fr/customize/custom-404-page.mdx
@@ -42,5 +42,5 @@ Configurez votre page 404 dans la section `errors.404` de votre fichier `docs.js
 </ResponseField>
 
 <ResponseField name="description" type="string">
-  Description personnalisée pour la page d’erreur 404. Prend en charge le formatage Markdown.
+  Description personnalisée pour la page d’erreur 404. Prend en charge le formatage MDX, notamment les liens, le texte en gras ou en italique, ainsi que les composants personnalisés.
 </ResponseField>
diff --git a/fr/deploy/ci.mdx b/fr/deploy/ci.mdx
@@ -435,3 +435,9 @@ Ce texte est ignoré par Vale
 ```
 
 Vale reconnaît et respecte automatiquement ces commentaires dans les fichiers MDX sans configuration supplémentaire. Utilisez les commentaires pour ignorer les lignes ou sections qui doivent être ignorées par le linter.
+
+<Warning>
+  Ne placez pas de commentaires d&#39;expression MDX tels que `{/* vale off */}` en tant qu&#39;enfants directs d&#39;un composant JSX entre des éléments frères. Par exemple, entre deux éléments `<Step>` à l&#39;intérieur d&#39;un composant `<Steps>`.
+
+  Placez les commentaires dans le contenu d&#39;un élément spécifique ou remaniez la structure du contenu pour éviter d&#39;avoir besoin de commentaires.
+</Warning>
-Original file line number
+Diff line change
@@ Expand Up @@
     Google Analytics tarda entre dos y tres días en mostrar tus datos.
-    Puedes usar el [Google Analytics Debugger](https://chrome.google.com/webstore/detail/google-analytics-debugger/jnkmfdileelhofjcijamephohjechhna?hl=en) para comprobar que Analytics está habilitado correctamente. La extensión registrará en la consola de tu navegador cada vez que GA4 haga una solicitud.
+    Puedes usar el [Google Analytics Debugger](https://chrome.google.com/webstore/detail/google-analytics-debugger/jnkmfdileelhofjcijamephohjechhna?hl=en) para comprobar tu configuración de Analytics. La extensión registra en la consola de tu navegador cada vez que GA4 hace una solicitud.
     <Note>
@@ Expand Down @@