mintlify · ethanpalm · Jul 21, 2026 · Jul 21, 2026 · Jul 21, 2026 · Jul 21, 2026
diff --git a/components/tree.mdx b/components/tree.mdx
@@ -9,6 +9,8 @@ Use tree components to display hierarchical structures like file systems, projec
 
 Create trees with either a Markdown list or the `Tree.Folder` and `Tree.File` components. `<Tree>` and `<FileTree>` are aliases, so either tag works with either syntax.
 
+Use the Markdown list syntax for quick, static trees where every folder can expand by default. Use the component syntax when you need to control open state per folder with `defaultOpen`, mark folders as non-interactive with `openable`, or mix files and folders at arbitrary depth.
+
 ## Markdown list syntax
 
 Write a nested Markdown list inside `<FileTree>` (or `<Tree>`) to describe a folder structure. Add a trailing slash to mark a folder, or nest items under it. Folders that contain nested items expand by default.

diff --git a/create/text.mdx b/create/text.mdx
@@ -36,6 +36,19 @@ By default, Mintlify generates an anchor ID from the heading text. Generated IDs
 
 When a page has multiple headings that generate the same ID, Mintlify adds `-2`, `-3`, and so on. The counter applies across the entire page, including headings nested inside components such as tabs.
 
+The following examples show how heading text maps to a generated anchor ID:
+
+| Heading text | Generated ID |
+| :--- | :--- |
+| `Getting started` | `getting-started` |
+| `Config.json options` | `config-json-options` |
+| `What's new` | `what’s-new` |
+| `Rate limits (per minute)` | `rate-limits-per-minute` |
+| `Read/write access` | `read/write-access` |
+| `Fees & billing` | `fees-&-billing` |
+| `OAuth` | `oauth` |
+| Duplicate `Overview` heading | `overview-2` |
+
 <Note>
   Mintlify's anchor IDs do not use GitHub-style slugging. Percent-encode non-ASCII characters when constructing a URL programmatically.
 </Note>

diff --git a/dashboard/audit-logs.mdx b/dashboard/audit-logs.mdx
@@ -79,6 +79,32 @@ Organization admins can add multiple destinations and choose which categories to
 
 5. Click **Add destination**.
 
+<AccordionGroup>
+  <Accordion title="Prepare Amazon S3 credentials">
+    Create an IAM user (or role with programmatic access credentials) whose policy allows writing to the target bucket. At minimum, grant `s3:PutObject` on the bucket and key prefix that you plan to use. For example:
+
+    ```json
+    {
+      "Version": "2012-10-17",
+      "Statement": [
+        {
+          "Effect": "Allow",
+          "Action": ["s3:PutObject"],
+          "Resource": "arn:aws:s3:::your-bucket-name/audit-logs/*"
+        }
+      ]
+    }
+    ```
+
+    Use the access key ID and secret access key from that IAM user when adding the destination. The key prefix is optional and is prepended to every object that Mintlify writes.
+  </Accordion>
+  <Accordion title="Prepare Datadog credentials">
+    Create a Datadog API key from **Organization Settings > API Keys** in your Datadog account. Do not use an application key.
+
+    Set the Datadog site to match the region where you host your Datadog account, for example `datadoghq.com` (US1), `us3.datadoghq.com`, `us5.datadoghq.com`, `datadoghq.eu` (EU1), `ap1.datadoghq.com`, or `ddog-gov.com`. Using the wrong site rejects the events.
+  </Accordion>
+</AccordionGroup>
+
 To stop streaming to a destination, open the streaming configuration and click the <Icon icon="trash-2" /> remove icon next to the destination.
 
 ### Select streamed categories
@@ -93,6 +119,6 @@ To stop streaming to a destination, open the streaming configuration and click t
 Export audit logs to CSV for analysis, compliance reporting, or long-term archival.
 
 1. Navigate to the [Audit log](https://app.mintlify.com/settings/organization/audit-logs) page of your dashboard.
-1. Optionally, apply filters to narrow down the logs you want to export.
-1. Click **Export CSV**.
-1. Mintlify sends you an email with a download link when the export is ready.
+2. Optionally, apply filters to narrow down the logs you want to export.
+3. Click **Export CSV**.
+4. Mintlify sends you an email with a download link when the export is ready.
diff --git a/es/agent/index.mdx b/es/agent/index.mdx
@@ -16,6 +16,16 @@ El agente es una herramienta de IA que crea solicitudes de extracción (pull req
 * **Valida**: Ejecuta comprobaciones con Mintlify CLI para asegurarse de que la documentación se compile correctamente.
 * **Publica los cambios**: Abre una solicitud de extracción con los cambios propuestos para revisión, o realiza confirmaciones directamente en tu branch de despliegue, según tu [ajuste de proceso de revisión](/es/agent/index#choose-how-the-agent-publishes-changes).
 
+<div id="how-to-use-the-agent">
+  ## Cómo usar el agente
+</div>
+
+Puedes enviar indicaciones al agente desde:
+
+- **Slack**: Menciona a `@Mintlify` en cualquier canal en el que esté el agente, o envía un mensaje directo a la aplicación. Consulta [Añadir el agente a Slack](/es/agent/slack).
+- **El dashboard**: Abre el panel del agente desde el [dashboard de Mintlify](https://app.mintlify.com) para iniciar una nueva conversación.
+- **Automatizaciones**: Activa el agente según una programación o a partir de un evento. Consulta [Automatizaciones](/es/automations/index).
+
 <div id="what-you-can-do-with-the-agent">
   ## Qué puedes hacer con el agente
 </div>

diff --git a/es/components/tree.mdx b/es/components/tree.mdx
@@ -9,6 +9,8 @@ Utiliza componentes de árbol para mostrar estructuras jerárquicas como sistema
 
 Puedes crear árboles con una lista de Markdown o con los componentes `Tree.Folder` y `Tree.File`. `<Tree>` y `<FileTree>` son alias, por lo que cualquiera de las etiquetas funciona con cualquiera de las sintaxis.
 
+Usa la sintaxis de lista de Markdown para árboles rápidos y estáticos en los que cada carpeta puede expandirse de forma predeterminada. Usa la sintaxis de componente cuando necesites controlar el estado de apertura de cada carpeta con `defaultOpen`, marcar carpetas como no interactivas con `openable`, o mezclar archivos y carpetas a una profundidad arbitraria.
+
 <div id="markdown-list-syntax">
   ## Sintaxis de lista de Markdown
 </div>
@@ -175,4 +177,6 @@ El componente de árbol admite la navegación con el teclado.
 
 <ResponseField name="name" type="string" required>
   El nombre del archivo que se muestra en el árbol.
-</ResponseField>
+</ResponseField>
+
+`Tree.File` solo acepta la prop `name`.
diff --git a/es/create/text.mdx b/es/create/text.mdx
@@ -42,6 +42,19 @@ De forma predeterminada, Mintlify genera un ID de anclaje a partir del texto del
 
 Cuando una página tiene varios encabezados que generan el mismo ID, Mintlify añade `-2`, `-3`, y así sucesivamente. El contador se aplica a toda la página, incluidos los encabezados anidados dentro de componentes como pestañas.
 
+Los siguientes ejemplos muestran cómo el texto del encabezado se convierte en un ID de anclaje generado:
+
+| Texto del encabezado | ID generado |
+| :--- | :--- |
+| `Getting started` | `getting-started` |
+| `Config.json options` | `config-json-options` |
+| `What's new` | `what’s-new` |
+| `Rate limits (per minute)` | `rate-limits-per-minute` |
+| `Read/write access` | `read/write-access` |
+| `Fees & billing` | `fees-&-billing` |
+| `OAuth` | `oauth` |
+| Encabezado `Overview` duplicado | `overview-2` |
+
 <Note>
   Los IDs de anclaje de Mintlify no usan el estilo de slug de GitHub. Codifica en porcentaje los caracteres no ASCII cuando construyas una URL de forma programática.
 </Note>

diff --git a/es/dashboard/audit-logs.mdx b/es/dashboard/audit-logs.mdx
@@ -87,6 +87,32 @@ Los administradores de la organización pueden agregar varios destinos y elegir
 
 5. Haz clic en **Add destination**.
 
+<AccordionGroup>
+  <Accordion title="Preparar credenciales de Amazon S3">
+    Crea un usuario de IAM (o un rol con credenciales de acceso programático) cuya política permita escribir en el bucket de destino. Como mínimo, otorga `s3:PutObject` en el bucket y el prefijo de clave que planeas usar. Por ejemplo:
+
+    ```json
+    {
+      "Version": "2012-10-17",
+      "Statement": [
+        {
+          "Effect": "Allow",
+          "Action": ["s3:PutObject"],
+          "Resource": "arn:aws:s3:::your-bucket-name/audit-logs/*"
+        }
+      ]
+    }
+    ```
+
+    Usa el access key ID y el secret access key de ese usuario de IAM al agregar el destino. El prefijo de clave es opcional y se antepone a cada objeto que Mintlify escribe.
+  </Accordion>
+  <Accordion title="Preparar credenciales de Datadog">
+    Crea una API key de Datadog desde **Organization Settings > API Keys** en tu cuenta de Datadog. No uses una application key.
+
+    Configura el sitio de Datadog para que coincida con la región donde está alojada tu cuenta de Datadog, por ejemplo `datadoghq.com` (US1), `us3.datadoghq.com`, `us5.datadoghq.com`, `datadoghq.eu` (EU1), `ap1.datadoghq.com` o `ddog-gov.com`. Usar un sitio incorrecto hace que se rechacen los eventos.
+  </Accordion>
+</AccordionGroup>
+
 Para dejar de transmitir a un destino, abre la configuración de transmisión y haz clic en el icono de eliminación <Icon icon="trash-2" /> junto al destino.
 
 <div id="select-streamed-categories">
@@ -105,6 +131,6 @@ Para dejar de transmitir a un destino, abre la configuración de transmisión y
 Exporta los registros de auditoría a CSV para su análisis, generación de informes de cumplimiento o archivo a largo plazo.
 
 1. Dirígete a la página de [Audit log](https://app.mintlify.com/settings/organization/audit-logs) de tu dashboard.
-1. Opcionalmente, aplica filtros para acotar los registros que quieres exportar.
-1. Haz clic en **Export CSV**.
-1. Mintlify te envía un correo electrónico con un enlace de descarga cuando la exportación esté lista.
+2. Opcionalmente, aplica filtros para acotar los registros que quieres exportar.
+3. Haz clic en **Export CSV**.
+4. Mintlify te envía un correo electrónico con un enlace de descarga cuando la exportación esté lista.
diff --git a/es/guides/claude-code.mdx b/es/guides/claude-code.mdx
@@ -29,6 +29,7 @@ Puedes entrenar a Claude Code para que comprenda tus estándares y flujos de tra
 3. (Opcional) Añade el archivo `CLAUDE.md` a tu proyecto.
 4. Ejecuta `claude` para empezar.
 
+Para confirmar tu configuración, hazle a Claude Code una pregunta como `Summarize the standards from CLAUDE.md and list the Mintlify components you can use`. Una sesión que funcione correctamente cita tu `CLAUDE.md` y hace referencia a componentes de Mintlify (por ejemplo, `Card`, `Steps` o `Accordion`) del skill cargado.
 
 <div id="template-for-claudemd">
   ## Plantilla para CLAUDE.md

diff --git a/es/guides/codex.mdx b/es/guides/codex.mdx
@@ -170,7 +170,7 @@ Verifica si esta nueva página sigue los estándares de redacción definidos en
 
 Conecta el servidor MCP de Mintlify a Codex para darle acceso a buscar en la documentación de Mintlify mientras te ayuda a escribir. Cuando conectas el servidor MCP, Codex puede consultar el uso de los componentes y las opciones de configuración sin que tengas que salir de la terminal.
 
-Agrega el servidor MCP a tu configuración global de Codex en `~/.codex/config.toml`:
+Agrega el servidor MCP a tu configuración global de Codex en `~/.codex/config.toml`. Crea el archivo si no existe:
 
 ```toml
 [mcp_servers.mintlify]
@@ -184,4 +184,8 @@ Para conectarte en su lugar al servidor MCP de tu propio sitio de documentación
 url = "https://your-docs.mintlify.site/mcp"
 ```
 
+Reinicia tu sesión de `codex` para que el cambio de configuración surta efecto. Para confirmar que el servidor MCP está conectado, pregúntale a Codex `Which MCP servers do you have access to?`: debería enumerar la entrada que acabas de añadir.
+
+Usar `config.toml` registra el servidor MCP para todas las sesiones de Codex en tu equipo. La indicación de skill y MCP en sesión mostrada anteriormente carga el mismo contexto bajo demanda dentro de una sola sesión: úsala para una ejecución puntual o cuando no puedas editar `config.toml`.
+
 Consulta [Model Context Protocol](/es/ai/model-context-protocol) para obtener más información sobre los servidores MCP y cómo encontrar el endpoint MCP de tu sitio.
diff --git a/fr/agent/index.mdx b/fr/agent/index.mdx
@@ -16,6 +16,16 @@ L'agent est un outil d'IA qui crée des pull requests (demandes de fusion) avec
 * **Valide** : exécute les vérifications de l'Interface en ligne de commande (CLI) Mintlify pour s'assurer que la documentation se génère correctement.
 * **Publie les modifications** : ouvre une pull request (demande de fusion) avec les modifications proposées pour relecture, ou pousse les modifications directement sur votre branche de déploiement, selon votre [paramètre de processus de relecture](/fr/agent/index#choose-how-the-agent-publishes-changes).
 
+<div id="how-to-use-the-agent">
+  ## Comment utiliser l'agent
+</div>
+
+Vous pouvez envoyer des prompts à l'agent depuis :
+
+- **Slack** : mentionnez `@Mintlify` dans n'importe quel canal auquel l'agent appartient, ou envoyez un message direct à l'application. Consultez [Ajouter l'agent à Slack](/fr/agent/slack).
+- **Le dashboard** : ouvrez le panneau de l'agent depuis le [dashboard Mintlify](https://app.mintlify.com) pour démarrer une nouvelle conversation.
+- **Automatisations** : déclenchez l'agent selon un planning ou à partir d'un événement. Consultez [Automatisations](/fr/automations/index).
+
 <div id="what-you-can-do-with-the-agent">
   ## Ce que vous pouvez faire avec l’agent
 </div>

diff --git a/fr/components/tree.mdx b/fr/components/tree.mdx
@@ -9,6 +9,8 @@ Utilisez des composants arborescents pour afficher des structures hiérarchiques
 
 Vous pouvez créer des arborescences avec une liste Markdown ou avec les composants `Tree.Folder` et `Tree.File`. `<Tree>` et `<FileTree>` sont des alias : chaque balise fonctionne avec l’une ou l’autre des syntaxes.
 
+Utilisez la syntaxe de liste Markdown pour des arborescences rapides et statiques dont chaque dossier peut se développer par défaut. Utilisez la syntaxe des composants lorsque vous devez contrôler l'état d'ouverture par dossier avec `defaultOpen`, marquer des dossiers comme non interactifs avec `openable`, ou mélanger des fichiers et des dossiers à une profondeur arbitraire.
+
 <div id="markdown-list-syntax">
   ## Syntaxe de liste Markdown
 </div>
@@ -175,4 +177,6 @@ Le composant d’arborescence prend en charge la navigation au clavier.
 
 <ResponseField name="name" type="string" required>
   Le nom du fichier affiché dans l'arborescence.
-</ResponseField>
+</ResponseField>
+
+`Tree.File` n'accepte que la prop `name`.
diff --git a/fr/create/text.mdx b/fr/create/text.mdx
@@ -42,6 +42,19 @@ Par défaut, Mintlify génère un ID d’ancrage à partir du texte du titre. Le
 
 Lorsqu’une page comporte plusieurs titres qui génèrent le même ID, Mintlify ajoute `-2`, `-3`, et ainsi de suite. Le compteur s’applique à l’ensemble de la page, y compris aux titres imbriqués dans des composants tels que les onglets.
 
+Les exemples suivants montrent comment le texte d’un titre est converti en ID d’ancrage généré :
+
+| Texte de l'en-tête | ID généré |
+| :--- | :--- |
+| `Getting started` | `getting-started` |
+| `Config.json options` | `config-json-options` |
+| `What's new` | `what’s-new` |
+| `Rate limits (per minute)` | `rate-limits-per-minute` |
+| `Read/write access` | `read/write-access` |
+| `Fees & billing` | `fees-&-billing` |
+| `OAuth` | `oauth` |
+| En-tête `Overview` en double | `overview-2` |
+
 <Note>
   Les IDs d’ancrage de Mintlify n’utilisent pas le slug de style GitHub. Encodez en pourcentage les caractères non ASCII lors de la construction programmatique d’une URL.
 </Note>

diff --git a/fr/dashboard/audit-logs.mdx b/fr/dashboard/audit-logs.mdx
@@ -87,6 +87,32 @@ Les administrateurs de l'organisation peuvent ajouter plusieurs destinations et
 
 5. Cliquez sur **Add destination**.
 
+<AccordionGroup>
+  <Accordion title="Préparer les identifiants Amazon S3">
+    Créez un utilisateur IAM (ou un rôle disposant d'identifiants d'accès programmatique) dont la politique autorise l'écriture dans le bucket cible. Accordez au minimum l'action `s3:PutObject` sur le bucket et le préfixe de clé que vous prévoyez d'utiliser. Par exemple :
+
+    ```json
+    {
+      "Version": "2012-10-17",
+      "Statement": [
+        {
+          "Effect": "Allow",
+          "Action": ["s3:PutObject"],
+          "Resource": "arn:aws:s3:::your-bucket-name/audit-logs/*"
+        }
+      ]
+    }
+    ```
+
+    Utilisez l'access key ID et la secret access key de cet utilisateur IAM lors de l'ajout de la destination. Le préfixe de clé est facultatif et est ajouté au début de chaque objet écrit par Mintlify.
+  </Accordion>
+  <Accordion title="Préparer les identifiants Datadog">
+    Créez une clé d'API Datadog depuis **Organization Settings > API Keys** dans votre compte Datadog. N'utilisez pas de clé d'application.
+
+    Définissez le site Datadog afin qu'il corresponde à la région où votre compte Datadog est hébergé, par exemple `datadoghq.com` (US1), `us3.datadoghq.com`, `us5.datadoghq.com`, `datadoghq.eu` (EU1), `ap1.datadoghq.com` ou `ddog-gov.com`. L'utilisation d'un site incorrect entraîne le rejet des événements.
+  </Accordion>
+</AccordionGroup>
+
 Pour arrêter la diffusion vers une destination, ouvrez la configuration de diffusion et cliquez sur l'icône de suppression <Icon icon="trash-2" /> à côté de la destination.
 
 <div id="select-streamed-categories">
@@ -105,6 +131,6 @@ Pour arrêter la diffusion vers une destination, ouvrez la configuration de diff
 Exportez les journaux d'audit au format CSV pour l'analyse, les rapports de conformité ou l'archivage à long terme.
 
 1. Accédez à la page [Audit log](https://app.mintlify.com/settings/organization/audit-logs) de votre dashboard.
-1. Le cas échéant, appliquez des filtres pour restreindre les journaux que vous souhaitez exporter.
-1. Cliquez sur **Export CSV**.
-1. Mintlify vous envoie un e-mail avec un lien de téléchargement lorsque l'export est prêt.
+2. Le cas échéant, appliquez des filtres pour restreindre les journaux que vous souhaitez exporter.
+3. Cliquez sur **Export CSV**.
+4. Mintlify vous envoie un e-mail avec un lien de téléchargement lorsque l'export est prêt.
diff --git a/fr/guides/claude-code.mdx b/fr/guides/claude-code.mdx
@@ -30,6 +30,8 @@ Vous pouvez entraîner Claude Code à comprendre vos normes et vos flux de trava
 4. Exécutez `claude` pour lancer.
 
 
+Pour vérifier votre configuration, posez à Claude Code une question du type `Summarize the standards from CLAUDE.md and list the Mintlify components you can use`. Une session opérationnelle cite votre `CLAUDE.md` et fait référence à des composants Mintlify (par exemple, `Card`, `Steps` ou `Accordion`) issus du skill chargé.
+
 <div id="claudemd-template">
   ## Modèle pour CLAUDE.md
 </div>

diff --git a/fr/guides/codex.mdx b/fr/guides/codex.mdx
@@ -170,7 +170,7 @@ Vérifiez si cette nouvelle page respecte les normes de rédaction d'AGENTS.md e
 
 Connectez le serveur MCP de Mintlify à Codex pour lui permettre de rechercher dans la documentation Mintlify tout en vous aidant à rédiger. Lorsque vous connectez le serveur MCP, Codex peut consulter l'utilisation des composants et les options de configuration sans que vous ayez à quitter le terminal.
 
-Ajoutez le serveur MCP à votre configuration globale Codex dans `~/.codex/config.toml` :
+Ajoutez le serveur MCP à votre configuration globale Codex dans `~/.codex/config.toml`. Créez le fichier s'il n'existe pas :
 
 ```toml
 [mcp_servers.mintlify]
@@ -184,4 +184,8 @@ Pour vous connecter au serveur MCP de votre propre site de documentation, rempla
 url = "https://your-docs.mintlify.site/mcp"
 ```
 
+Redémarrez votre session `codex` pour que la modification de la configuration prenne effet. Pour vérifier que le serveur MCP est connecté, demandez à Codex `Which MCP servers do you have access to?` — il doit lister l'entrée que vous venez d'ajouter.
+
+L'utilisation de `config.toml` enregistre le serveur MCP pour chaque session Codex sur votre machine. Le skill en session et le prompt MCP présentés plus haut chargent le même contexte à la demande dans une seule session — utilisez-les pour une exécution ponctuelle ou lorsque vous ne pouvez pas modifier `config.toml`.
+
 Consultez [Model Context Protocol](/fr/ai/model-context-protocol) pour plus d'informations sur les serveurs MCP et savoir comment trouver le point de terminaison MCP de votre site.