Documentation quality check: address reader-question gaps

api-playground/mdx-setup.mdx

@@ -76,7 +76,7 @@ You can manually define API endpoints in individual MDX pages. This approach is
 
   </Step>
   <Step title="Add parameters and responses">
-    Use [parameter and response fields](/components/fields) to document your endpoint's parameters and return values.
+    Use [parameter and response fields](/components/fields) to document your endpoint's parameters and return values. To show request and response code samples in the right sidebar, wrap them in [`<RequestExample>` and `<ResponseExample>`](/components/examples) components.
 
     ```mdx
     <ParamField path="userId" type="string" required>

automations/create.mdx

@@ -47,6 +47,13 @@ For more examples and patterns, see [Use automations](/guides/use-automations).
 
 <GitlabAutomationSetup />
 
+## Edit a custom automation
+
+1. Open the [Automations](https://app.mintlify.com/products/automations) page in your dashboard.
+2. Click the <Icon icon="settings" /> settings button beside an automation.
+3. Update any of the fields described in [Configurations](/automations/manage#configurations).
+4. Click **Save**.
+
 ## Delete a custom automation
 
 Deleting an automation is permanent and removes its configuration and run history.

dashboard/network-access.mdx

@@ -21,8 +21,10 @@
 
 You can allow access two ways:
 
-- **Individual IP address**: Allow a single address, such as `203.0.113.7`.
-- **CIDR range**: Allow a block of addresses, such as `10.0.0.0/8`. Use CIDR notation to grant access to an entire office or VPN network without listing each address individually.
+- **Individual IP address**: Allow a single address, such as `203.0.113.7` or `2001:db8::1`.
+- **CIDR range**: Allow a block of addresses, such as `10.0.0.0/8` or `2001:db8::/48`. Use CIDR notation to grant access to an entire office or VPN network without listing each address individually.
+
+Both IPv4 and IPv6 addresses are supported.
 
 ### Configure the IP allowlist
 
@@ -41,7 +43,7 @@
 Control how long dashboard sessions stay valid before members must sign in again. You can set two independent limits:
 
 - **Maximum session lifetime**: Members must sign in again once a session reaches this age, regardless of activity. When off, sessions have no maximum age.
 - **Idle session timeout**: Members are signed out after this period of inactivity. When off, sessions time out after 14 days of inactivity.
 
 Both limits accept values from 5 minutes to 14 days.
 

deploy/reverse-proxy.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Reverse proxy"
-description: "Configure a custom reverse proxy with Nginx, Apache, or Caddy to serve your Mintlify documentation at a subpath on your own domain."
+description: "Configure a custom reverse proxy to serve your Mintlify documentation at a subpath on your own domain."
 keywords: ["reverse proxy configuration","nginx","proxy routing","header forwarding"]
 ---
 

deploy/route53-cloudfront.mdx

@@ -1,7 +1,7 @@
 ---
 title: "Deploy at a subpath with AWS Route 53 and CloudFront"
 sidebarTitle: "AWS"
-description: "Deploy your Mintlify documentation at a subpath on AWS using Route 53 for DNS routing and CloudFront as a CDN with Lambda@Edge functions."
+description: "Deploy your Mintlify documentation at a subpath on AWS using Route 53 for DNS routing and CloudFront as a CDN."
 keywords: ["AWS deployment", "Route 53 DNS", "CloudFront CDN", "cache policies"]
 ---
 
@@ -135,7 +135,7 @@
 - Set "Cache policy" to **CachingDisabled**.
 - Set "Origin request policy" to **AllViewerExceptHostHeader**.
 - Set "Viewer protocol policy" to **Redirect HTTP to HTTPS**.
 - Set "Allowed HTTP methods" to **GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE**.
 
 <Warning>
   CloudFront only allows `GET` and `HEAD` requests by default. If you don't allow all HTTP methods, CloudFront rejects the `POST` requests that Mintlify uses for analytics. Your dashboard won't show any page views even though your docs load normally.
@@ -154,7 +154,7 @@
 - Set "Cache policy" to **CachingDisabled**.
 - Set "Origin request policy" to **AllViewerExceptHostHeader**.
 - Set "Viewer protocol policy" to **Redirect HTTP to HTTPS**.
 - Set "Allowed HTTP methods" to **GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE**.
 
 ### `/mintlify-assets/*`
 
@@ -171,7 +171,7 @@
 - Set "Cache policy" to **CachingDisabled**.
 - Set "Origin request policy" to **AllViewerExceptHostHeader**.
 - Set "Viewer protocol policy" to **Redirect HTTP to HTTPS**.
 - Set "Allowed HTTP methods" to **GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE**.
 
 ### `Default (*)`
 

editor/pages.mdx

@@ -40,7 +40,7 @@ Right-click any folder in the Files view and select **New file**. Enter a filena
 
 ## Edit content
 
-Switch between visual and source mode using the mode toggle in the toolbar below the top bar. To switch to visual mode, click the <Icon icon="eye" /> eye icon or press <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>M</kbd> (macOS) or <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>M</kbd> (Windows). To switch to source mode, click the <Icon icon="code" /> code icon or press the same shortcut.
+Switch between visual and source mode using the mode toggle in the toolbar below the top bar. To switch to visual mode, click the <Icon icon="eye" /> eye icon or press <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> (macOS) or <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> (Windows). To switch to source mode, click the <Icon icon="code" /> code icon or press the same shortcut.
 
 **Visual mode** shows a real-time preview as you type. Press <kbd>/</kbd> to open the component menu and insert components, images, videos, and other content. You can also drag and drop media files directly onto the page from your computer or from the navigation tree. Other shortcuts:
 

es/api-playground/mdx-setup.mdx

@@ -78,7 +78,7 @@ Puedes definir endpoints de API manualmente en páginas MDX individuales. Este e
   </Step>
 
   <Step title="Añadir parámetros y respuestas">
-    Utiliza los [campos de parámetros y de respuesta](/es/components/fields) para documentar los parámetros y los valores de retorno de tu endpoint.
+    Utiliza los [campos de parámetros y de respuesta](/es/components/fields) para documentar los parámetros y los valores de retorno de tu endpoint. Para mostrar ejemplos de código de solicitud y respuesta en la barra lateral derecha, envuélvelos en los componentes [`<RequestExample>` y `<ResponseExample>`](/es/components/examples).
 
     ```mdx
     <ParamField path="userId" type="string" required>

es/automations/create.mdx

@@ -51,6 +51,15 @@ Para ver más ejemplos y patrones, consulta [Usar automatizaciones](/es/guides/u
 
 <GitlabAutomationSetup />
 
+<div id="edit-a-custom-automation">
+## Editar una automatización personalizada
+</div>
+
+1. Abre la página [Automatizaciones](https://app.mintlify.com/products/automations) en tu dashboard.
+2. Haz clic en el botón de configuración <Icon icon="settings" /> junto a una automatización.
+3. Actualiza cualquiera de los campos descritos en [Configuraciones](/es/automations/manage#configurations).
+4. Haz clic en **Save**.
+
 <div id="delete-a-custom-automation">
 ## Eliminar una automatización personalizada
 </div>

es/dashboard/network-access.mdx

@@ -23,8 +23,10 @@ Cuando un miembro intenta iniciar sesión o usar el dashboard desde una direcci
 
 Puedes permitir el acceso de dos formas:
 
-- **Dirección IP individual**: permite una única dirección, como `203.0.113.7`.
-- **Rango CIDR**: permite un bloque de direcciones, como `10.0.0.0/8`. Usa la notación CIDR para conceder acceso a toda una oficina o red VPN sin listar cada dirección de forma individual.
+- **Dirección IP individual**: permite una única dirección, como `203.0.113.7` o `2001:db8::1`.
+- **Rango CIDR**: permite un bloque de direcciones, como `10.0.0.0/8` o `2001:db8::/48`. Usa la notación CIDR para conceder acceso a toda una oficina o red VPN sin listar cada dirección de forma individual.
+
+Se admiten direcciones IPv4 e IPv6.
 
 <div id="configure-the-ip-allowlist">
   ### Configurar la lista de IP permitidas

es/deploy/reverse-proxy.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Proxy inverso"
-description: "Configura un proxy inverso personalizado con Nginx, Apache o Caddy para servir tu documentación de Mintlify en una subruta de tu propio dominio."
+description: "Configura un proxy inverso personalizado para servir tu documentación de Mintlify en una subruta de tu propio dominio."
 keywords: ["reverse proxy configuration","nginx","proxy routing","header forwarding"]
 ---
 

es/deploy/route53-cloudfront.mdx

@@ -1,7 +1,7 @@
 ---
 title: "Despliega en una subruta con AWS Route 53 y CloudFront"
 sidebarTitle: "AWS"
-description: "Despliega tu documentación de Mintlify en una subruta en AWS usando Route 53 para el enrutamiento DNS y CloudFront como CDN con funciones Lambda@Edge."
+description: "Despliega tu documentación de Mintlify en una subruta en AWS usando Route 53 para el enrutamiento DNS y CloudFront como CDN."
 keywords: ["implementación en AWS", "Route 53 DNS", "CloudFront CDN", "políticas de caché"]
 ---
 

es/editor/pages.mdx

@@ -64,7 +64,7 @@ Haga clic con el botón derecho en cualquier carpeta de la vista Files y selecci
 
 </div>
 
-Alterne entre el modo visual y source usando el conmutador de modo en la barra de herramientas debajo de la barra superior. Haga clic en el icono <Icon icon="eye" /> de ojo o presione <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> (macOS) o <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> (Windows) para cambiar al modo visual. Haga clic en el icono <Icon icon="code" /> de código o presione <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> (macOS) o <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> (Windows) para cambiar al modo source.
+Alterne entre el modo visual y source usando el conmutador de modo en la barra de herramientas debajo de la barra superior. Para cambiar al modo visual, haga clic en el icono <Icon icon="eye" /> de ojo o presione <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> (macOS) o <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> (Windows). Para cambiar al modo source, haga clic en el icono <Icon icon="code" /> de código o presione el mismo atajo.
 
 **El modo visual** muestra una vista previa en tiempo real a medida que escribe. Presione <kbd>/</kbd> para abrir el menú de componentes e insertar componentes, imágenes, vídeos y otro contenido. También puede arrastrar y soltar archivos multimedia directamente sobre la página desde su ordenador o desde el árbol de navegación. Otros atajos:
 

es/integrations/privacy/osano.mdx

@@ -11,7 +11,7 @@ Añade el consentimiento de cookies de [Osano](https://www.osano.com/) a tu docu
   ## Configuración
 </div>
 
-Crea un archivo `osano.js` en tu repositorio de documentación con el siguiente contenido:
+Crea un archivo `osano.js` en cualquier ubicación dentro de tu directorio de contenido con el siguiente contenido. Mintlify incluye automáticamente cualquier archivo `.js` de tu directorio de contenido en todas las páginas.
 
 <CodeGroup>
   ```js Format

es/optimize/feedback.mdx

@@ -67,7 +67,7 @@ Para recopilar y ver los comentarios de los usuarios, debes habilitar los coment
   ## Gestionar comentarios
 </div>
 
-Puedes establecer el estado de un comentario y añadir notas internas para realizar un seguimiento de tu trabajo resolviendo los comentarios de los usuarios.
+Puedes establecer el estado de un comentario y añadir notas internas para realizar un seguimiento de tu trabajo resolviendo los comentarios de los usuarios. Para analizar los comentarios fuera del dashboard, [expórtalos a CSV](/es/optimize/analytics#export-analytics) desde la página de analítica.
 
 <div id="change-feedback-status">
   ### Cambiar el estado de un comentario

es/organize/navigation.mdx

@@ -920,6 +920,8 @@ Puedes anidar elementos de navigation entre sí para crear jerarquías complejas
 
 Cada elemento de navigation puede contener un solo tipo de elemento hijo en cada nivel de tu jerarquía de navigation. Por ejemplo, una pestaña puede contener elementos de anclaje que contienen grupos, pero una pestaña no puede contener tanto elementos de anclaje como grupos en el mismo nivel.
 
+Mezclar tipos de elementos hijos incompatibles en el mismo nivel provoca un fallo en la validación del esquema. Ejecuta [`mint validate`](/es/cli/commands#mint-validate) localmente antes de publicar para detectar estos errores.
+
 <CodeGroup>
 
 ```json Pestañas que contienen tabs

es/search-index/index.mdx

@@ -10,7 +10,7 @@ Mintlify Index proporciona a los agentes de programación una única capa de bú
 Usa Index mediante el servidor MCP público o la API REST con control de acceso.
 
 - **Servidor MCP**: Conecta una herramienta de IA y permite que recupere contexto con fuentes citadas mientras trabajas. Está disponible públicamente. No requiere una clave de API.
-- **API REST**: Busca fuentes clasificadas, reúne contexto dentro de un presupuesto de tokens o recupera el contenido de resultados seleccionados. Tiene control de acceso. Requiere una clave de API de Index.
+- **API REST**: Busca fuentes clasificadas, reúne contexto dentro de un presupuesto de tokens o recupera el contenido de resultados seleccionados. Tiene control de acceso. Requiere una [clave de API de Index](/es/api/search-index/introduction#authentication).
 
 <div id="get-started">
   ## Primeros pasos

fr/api-playground/mdx-setup.mdx

@@ -78,7 +78,7 @@ Vous pouvez définir manuellement des endpoints d'API dans des pages MDX ind
   </Step>
 
   <Step title="Ajouter des paramètres et des réponses">
-    Utilisez les [champs de paramètres et de réponse](/fr/components/fields) pour documenter les paramètres et les valeurs renvoyées par votre endpoint.
+    Utilisez les [champs de paramètres et de réponse](/fr/components/fields) pour documenter les paramètres et les valeurs renvoyées par votre endpoint. Pour afficher des exemples de code de requête et de réponse dans la barre latérale de droite, encapsulez-les dans des composants [`<RequestExample>` et `<ResponseExample>`](/fr/components/examples).
 
     ```mdx
     <ParamField path="userId" type="string" required>

fr/automations/create.mdx

@@ -51,6 +51,15 @@ Pour plus d'exemples et de modèles, consultez [Utiliser les automatisations](/f
 
 <GitlabAutomationSetup />
 
+<div id="edit-a-custom-automation">
+  ## Modifier une automatisation personnalisée
+</div>
+
+1. Ouvrez la page [Automations](https://app.mintlify.com/products/automations) dans votre dashboard.
+2. Cliquez sur le bouton <Icon icon="settings" /> de paramètres à côté d'une automatisation.
+3. Mettez à jour n'importe quel des champs décrits dans [Configurations](/fr/automations/manage#configurations).
+4. Cliquez sur **Save**.
+
 <div id="delete-a-custom-automation">
   ## Supprimer une automatisation personnalisée
 </div>

fr/dashboard/network-access.mdx

@@ -23,8 +23,10 @@ Lorsqu'un membre tente de se connecter ou d'utiliser le dashboard depuis une adr
 
 Vous pouvez autoriser l'accès de deux façons :
 
-- **Adresse IP individuelle** : autorisez une seule adresse, telle que `203.0.113.7`.
-- **Plage CIDR** : autorisez un bloc d'adresses, tel que `10.0.0.0/8`. Utilisez la notation CIDR pour accorder l'accès à un bureau entier ou à un réseau VPN sans lister chaque adresse individuellement.
+- **Adresse IP individuelle** : autorisez une seule adresse, telle que `203.0.113.7` ou `2001:db8::1`.
+- **Plage CIDR** : autorisez un bloc d'adresses, tel que `10.0.0.0/8` ou `2001:db8::/48`. Utilisez la notation CIDR pour accorder l'accès à un bureau entier ou à un réseau VPN sans lister chaque adresse individuellement.
+
+Les adresses IPv4 et IPv6 sont toutes deux prises en charge.
 
 <div id="configure-the-ip-allowlist">
   ### Configurer la liste d'adresses IP autorisées

fr/deploy/reverse-proxy.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Proxy inverse"
-description: "Configurez un proxy inverse personnalisé avec Nginx, Apache ou Caddy pour servir votre documentation Mintlify sur un sous-chemin de votre propre domaine."
+description: "Configurez un proxy inverse personnalisé pour servir votre documentation Mintlify sur un sous-chemin de votre propre domaine."
 keywords: ["configuration de proxy inverse", "nginx", "routage du proxy", "transmission des en-têtes"]
 ---
 

fr/deploy/route53-cloudfront.mdx

@@ -1,7 +1,7 @@
 ---
 title: "Déployer sur un sous-chemin avec AWS Route 53 et CloudFront"
 sidebarTitle: "AWS"
-description: "Déployez votre documentation Mintlify sur un sous-chemin AWS en utilisant Route 53 pour le routage DNS et CloudFront comme CDN avec des fonctions Lambda@Edge."
+description: "Déployez votre documentation Mintlify sur un sous-chemin AWS en utilisant Route 53 pour le routage DNS et CloudFront comme CDN."
 keywords: ["déploiement AWS", "Route 53 DNS", "CloudFront CDN", "stratégies de cache"]
 ---
 

fr/integrations/privacy/osano.mdx

@@ -11,7 +11,7 @@ Ajoutez la gestion du consentement aux cookies [Osano](https://www.osano.com/) 
   ## Configuration
 </div>
 
-Créez un fichier `osano.js` dans le référentiel de votre documentation avec le contenu suivant :
+Créez un fichier `osano.js` n'importe où dans votre répertoire de contenu avec le contenu suivant. Mintlify inclut automatiquement tout fichier `.js` de votre répertoire de contenu sur chaque page.
 
 <CodeGroup>
   ```js Format

fr/optimize/feedback.mdx

@@ -67,7 +67,7 @@ Pour collecter et consulter les retours des utilisateurs, vous devez les activer
   ## Gérer les retours
 </div>
 
-Vous pouvez définir le statut d'un retour et ajouter des notes internes pour suivre votre travail de traitement des retours des utilisateurs.
+Vous pouvez définir le statut d'un retour et ajouter des notes internes pour suivre votre travail de traitement des retours des utilisateurs. Pour analyser les retours en dehors du tableau de bord, [exportez-les au format CSV](/fr/optimize/analytics#export-analytics) depuis la page analytics.
 
 <div id="change-feedback-status">
   ### Modifier le statut d'un retour

fr/organize/navigation.mdx

@@ -920,6 +920,8 @@ Vous pouvez imbriquer des éléments de navigation les uns dans les autres pour
 
 Chaque élément de navigation peut contenir un type d'élément enfant à chaque niveau de votre hiérarchie de navigation. Par exemple, un Onglet peut contenir des ancres qui contiennent des groupes, mais un Onglet ne peut pas contenir à la fois des ancres et des groupes au même niveau.
 
+Mélanger des types d'enfants incompatibles au même niveau échoue à la validation du schéma. Exécutez [`mint validate`](/fr/cli/commands#mint-validate) localement avant de publier pour détecter ces erreurs.
+
 <CodeGroup>
 
 ```json Tabs contenant des tabs

fr/search-index/index.mdx

@@ -10,7 +10,7 @@ Mintlify Index fournit aux agents de programmation une couche de recherche uniqu
 Utilisez Index via le serveur MCP public ou l’API REST soumise à un contrôle d’accès.
 
 - **Serveur MCP** : Connectez un outil d’IA et laissez-le récupérer du contexte accompagné de ses sources pendant votre travail. Disponible publiquement. Ne nécessite pas de clé d’API.
-- **API REST** : Recherchez des sources classées, assemblez un contexte dans une limite de jetons ou récupérez le contenu de résultats sélectionnés. Soumise à un contrôle d’accès. Nécessite une clé d’API Index.
+- **API REST** : Recherchez des sources classées, assemblez un contexte dans une limite de jetons ou récupérez le contenu de résultats sélectionnés. Soumise à un contrôle d’accès. Nécessite une [clé d’API Index](/fr/api/search-index/introduction#authentication).
 
 <div id="get-started">
   ## Commencer

integrations/privacy/osano.mdx

@@ -9,7 +9,7 @@ Add [Osano](https://www.osano.com/) cookie consent to your docs with a [custom J
 
 ## Setup
 
-Create an `osano.js` file in your docs repository with the following content:
+Create an `osano.js` file inside your content directory with the following content.
 
 <CodeGroup>
 

optimize/feedback.mdx

@@ -64,7 +64,7 @@ To collect and view feedback from users, you must enable feedback from the [Add-
 
 ## Manage feedback
 
-You can set the status of a piece of feedback and add internal notes to track your work resolving user feedback.
+You can set the status of a piece of feedback and add internal notes to track your work resolving user feedback. To analyze feedback outside the dashboard, [export it to CSV](/optimize/analytics#export-analytics) from the analytics page.
 
 ### Change feedback status
 

organize/navigation.mdx

@@ -870,6 +870,8 @@ You can nest navigation elements within each other to create complex hierarchies
 
 Each navigation element can contain one type of child element at each level of your navigation hierarchy. For example, a tab can contain anchors that contain groups, but a tab cannot contain both anchors and groups at the same level.
 
+Mixing incompatible child types at the same level fails schema validation. Run [`mint validate`](/cli/commands#mint-validate) locally before publishing to catch these errors.
+
 <CodeGroup>
 
 ```json Tabs containing anchors

search-index/index.mdx

@@ -10,7 +10,7 @@ Mintlify Index gives coding agents one search layer for technical knowledge. It
 Use Index through the public MCP server or the access-controlled REST API.
 
 - **MCP server**: Connect an AI tool and let it retrieve source-cited context while you work. Publicly available. Does not require an API key.
-- **REST API**: Search for ranked sources, assemble context within a token budget, or retrieve the contents of selected results. Access-controlled. Requires an Index API key.
+- **REST API**: Search for ranked sources, assemble context within a token budget, or retrieve the contents of selected results. Access-controlled. Requires an [Index API key](/api/search-index/introduction#authentication).
 
 ## Get started
 

zh/api-playground/mdx-setup.mdx

@@ -78,7 +78,7 @@ keywords: ["API 文档", "端点文档"]
   </Step>
 
   <Step title="添加参数与响应">
-    使用[参数和响应字段](/zh/components/fields)为端点的参数和返回值编写文档。
+    使用[参数和响应字段](/zh/components/fields)为端点的参数和返回值编写文档。若要在右侧边栏中显示请求和响应代码示例，请将其包装在 [`<RequestExample>` 和 `<ResponseExample>`](/zh/components/examples) 组件中。
 
     ```mdx
     <ParamField path="userId" type="string" required>