From 2cb7bff1427956d0010f186f89821ece6c29e60d Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Wed, 5 Aug 2026 16:39:59 +0000
Subject: [PATCH 1/6] docs: document agent analytics and editor appearance
---
editor/settings.mdx | 31 ++++++++++++++++++++++----
es/editor/settings.mdx | 47 +++++++++++++++++++++++++++++++++++----
es/optimize/analytics.mdx | 15 +++++++++++++
fr/editor/settings.mdx | 47 +++++++++++++++++++++++++++++++++++----
fr/optimize/analytics.mdx | 15 +++++++++++++
optimize/analytics.mdx | 17 +++++++++-----
zh/editor/settings.mdx | 39 ++++++++++++++++++++++++++++----
zh/optimize/analytics.mdx | 15 +++++++++++++
8 files changed, 204 insertions(+), 22 deletions(-)
diff --git a/editor/settings.mdx b/editor/settings.mdx
index 317ffadcc6..5bdf0c9597 100644
--- a/editor/settings.mdx
+++ b/editor/settings.mdx
@@ -4,12 +4,35 @@ description: "Configure AI instructions, pull request defaults, and the default
keywords: ["editor", "settings", "ai", "instructions", "publishing", "pull request", "merge", "lock branch"]
---
-The web editor has two layers of settings:
+The web editor groups settings into four sections:
-- **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 you commit changes and turn them into pull requests.
+- **Appearance** and **Chat** apply only to you.
+- **Publishing** applies to everyone on a deployment and controls what happens when you commit changes and turn them into pull requests.
+- **Danger zone** contains actions that can discard unpublished changes.
-You can configure both from the settings panel. To open it, click the settings icon in the editor toolbar.
+You can configure these settings from the settings panel. To open it, click the settings icon in the editor toolbar, then select a section.
+
+## Appearance
+
+Appearance settings control how the editor looks while you work. These preferences apply only to you.
+
+### Fit the editor to full width
+
+Enable **Fit editor to full width** when you need more horizontal space for wide content or source files. The editor stretches the editing canvas edge-to-edge instead of using the default 768px column.
+
+### Open live preview in a new tab
+
+Enable **Open live preview in new tab** when you want to keep the editor open while viewing the rendered page in a separate browser tab. When you preview your site, Mintlify opens the rendered page in a new tab.
+
+### Show hidden files
+
+Enable **Show hidden files** when you need to edit dotfiles or other hidden files. Mintlify displays them in the navigation sidebar. You can also press ⌘⇧. on macOS or Ctrl+Shift+. on other platforms to toggle this preference.
+
+To configure an appearance preference:
+
+1. Click the settings icon in the editor toolbar.
+2. Select **Appearance**.
+3. Turn the preference on or off.
## AI instructions
diff --git a/es/editor/settings.mdx b/es/editor/settings.mdx
index f21f5c9538..ba338864ab 100644
--- a/es/editor/settings.mdx
+++ b/es/editor/settings.mdx
@@ -4,12 +4,51 @@ description: "Configure instrucciones de IA, valores por defecto de pull request
keywords: ["editor", "settings", "ai", "instructions", "publishing", "pull request", "merge", "lock branch"]
---
-El editor web tiene dos capas de configuración:
+La configuración del editor se divide en cuatro secciones:
-- **Su configuración** se aplica solo a usted y controla cómo la IA del editor le ayuda con sus ediciones.
-- **La configuración de publicación** se aplica a todos en un deployment y determina qué sucede cuando confirma cambios y los convierte en pull requests.
+- **Apariencia** y **Chat** se aplican solo a usted.
+- **Publicación** se aplica a todos en un deployment y controla qué sucede cuando confirma cambios y los convierte en pull requests.
+- **Zona de peligro** contiene acciones que pueden descartar cambios sin publicar.
-Puede configurar ambas desde el panel de configuración. Para abrirlo, haga clic en el icono de configuración en la barra de herramientas del editor.
+Puede configurar estos ajustes desde el panel de configuración. Para abrirlo, haga clic en el icono de configuración en la barra de herramientas del editor y seleccione una sección.
+
+
diff --git a/es/optimize/analytics.mdx b/es/optimize/analytics.mdx
index d79ecdb382..2649de8be6 100644
--- a/es/optimize/analytics.mdx
+++ b/es/optimize/analytics.mdx
@@ -39,6 +39,21 @@ Revisa tus analíticas de tráfico para:
/>
+
+ ## Agentes
+
+
+La sección **Agentes** te ayuda a entender cómo los agentes de IA acceden a tu documentación. Muestra las vistas de agentes y humanas a lo largo del tiempo y clasifica las páginas o los agentes según la métrica seleccionada.
+
+Usa las analíticas de agentes para:
+
+- **Supervisar el tráfico de IA**: realiza un seguimiento de los cambios en el tráfico de agentes después de publicar o actualizar contenido.
+- **Encontrar las páginas más utilizadas por los agentes**: selecciona **Agent views** en Clasificaciones para identificar las páginas a las que acceden con frecuencia las herramientas de IA.
+- **Identificar los agentes activos**: selecciona **Agent visitors** en Clasificaciones para ver qué agentes acceden a tu documentación con más frecuencia.
+- **Comparar fuentes de tráfico**: usa el selector de Clasificaciones para comparar vistas humanas, vistas de agentes, referencias y visitantes agentes.
+
+La sección **Agentes** está disponible cuando tu deployment tiene acceso a Advanced Analytics. Para verla, abre [Analíticas](https://app.mintlify.com/analytics) y selecciona **Agent**. Usa el selector de intervalo de fechas para cambiar el periodo del informe.
+
### Vistas de agentes
diff --git a/fr/editor/settings.mdx b/fr/editor/settings.mdx
index 02d8611a92..b2ce67c7f4 100644
--- a/fr/editor/settings.mdx
+++ b/fr/editor/settings.mdx
@@ -4,12 +4,51 @@ description: "Configurez les instructions IA, les valeurs par défaut des pull r
keywords: ["editor", "settings", "ai", "instructions", "publishing", "pull request", "merge", "lock branch"]
---
-L'éditeur web comporte deux niveaux de paramètres :
+Les paramètres de l'éditeur sont regroupés en quatre sections :
-- **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 vous validez des modifications et les transformez en pull requests.
+- **Apparence** et **Chat** s'appliquent uniquement à vous.
+- **Publication** s'applique à toutes les personnes d'un déploiement et contrôle ce qui se passe lorsque vous validez des modifications et les transformez en pull requests.
+- La **zone dangereuse** contient des actions qui peuvent supprimer des modifications non publiées.
-Vous pouvez configurer les deux depuis le panneau des paramètres. Pour l'ouvrir, cliquez sur l'icône de paramètres
dans la barre d'outils de l'éditeur.
+Vous pouvez configurer ces paramètres depuis le panneau des paramètres. Pour l'ouvrir, cliquez sur l'icône de paramètres
dans la barre d'outils de l'éditeur, puis sélectionnez une section.
+
+
+
+## Apparence
+
+
+
+Les paramètres d'apparence contrôlent l'aspect de l'éditeur pendant votre travail. Ces préférences ne s'appliquent qu'à vous.
+
+
+
+### Adapter l'éditeur à toute la largeur
+
+
+
+Activez **Fit editor to full width** lorsque vous avez besoin de plus d'espace horizontal pour des contenus ou des fichiers source larges. L'éditeur étend le canevas de modification sur toute la largeur au lieu d'utiliser la colonne par défaut de 768 px.
+
+
+
+### Ouvrir l'aperçu en direct dans un nouvel onglet
+
+
+
+Activez **Open live preview in new tab** lorsque vous voulez garder l'éditeur ouvert tout en affichant la page rendue dans un onglet distinct du navigateur. Lorsque vous prévisualisez votre site, Mintlify ouvre la page rendue dans un nouvel onglet.
+
+
+
+### Afficher les fichiers masqués
+
+
+
+Activez **Show hidden files** lorsque vous devez modifier des fichiers dot ou d'autres fichiers masqués. Mintlify les affiche dans la barre latérale de navigation. Vous pouvez aussi appuyer sur
⌘⇧. sur macOS ou
Ctrl+Shift+. sur les autres plateformes pour activer ou désactiver cette préférence.
+
+Pour configurer une préférence d'apparence :
+
+1. Cliquez sur l'icône de paramètres
dans la barre d'outils de l'éditeur.
+2. Sélectionnez **Appearance**.
+3. Activez ou désactivez la préférence.
diff --git a/fr/optimize/analytics.mdx b/fr/optimize/analytics.mdx
index cb2e92c7d5..ae624ddcae 100644
--- a/fr/optimize/analytics.mdx
+++ b/fr/optimize/analytics.mdx
@@ -39,6 +39,21 @@ Examinez vos analyses de trafic pour :
/>
+
+ ## Agents
+
+
+La section **Agents** vous aide à comprendre comment les agents IA accèdent à votre documentation. Elle affiche les vues des agents et des humains au fil du temps et classe les pages ou les agents selon la métrique sélectionnée.
+
+Utilisez les analyses des agents pour :
+
+- **Surveiller le trafic IA** : suivez l'évolution du trafic des agents après la publication ou la mise à jour de contenu.
+- **Trouver les pages les plus utilisées par les agents** : sélectionnez **Agent views** dans Classements pour identifier les contenus auxquels les outils IA accèdent fréquemment.
+- **Identifier les agents actifs** : sélectionnez **Agent visitors** dans Classements pour voir quels agents accèdent le plus souvent à votre documentation.
+- **Comparer les sources de trafic** : utilisez le sélecteur Classements pour comparer les vues humaines, les vues des agents, les recommandations et les visiteurs agents.
+
+La section **Agents** est disponible lorsque votre déploiement dispose de l'accès à Advanced Analytics. Pour l'afficher, ouvrez [Analytics](https://app.mintlify.com/analytics) et sélectionnez **Agent**. Utilisez le sélecteur de plage de dates pour modifier la période du rapport.
+
### Vues des agents
diff --git a/optimize/analytics.mdx b/optimize/analytics.mdx
index 0b369ea9b8..896e4345e6 100644
--- a/optimize/analytics.mdx
+++ b/optimize/analytics.mdx
@@ -37,15 +37,20 @@ Review your traffic analytics to:
/>
-### Agent views
+## Agent
-Mintlify identifies agent visitors by IP address and user agent. The agent visitor count approximates distinct sources of AI traffic rather than individual agent sessions or conversations. Multiple requests from the same IP address count as one visitor.
+The Agent section helps you understand how AI agents access your documentation. It shows agent and human views over time and ranks pages or agents by the selected metric.
+
+Use Agent analytics when you want to:
-Use agent views to help determine:
+- **Monitor AI traffic**: Track changes in agent traffic after you publish or update content.
+- **Find pages agents use most**: Select **Agent views** in Rankings to identify the pages that AI tools access frequently.
+- **Identify active agents**: Select **Agent visitors** in Rankings to see which agents access your documentation most often.
+- **Compare traffic sources**: Use the Rankings selector to compare agent views, human views, referrals, and agent visitors.
-- **AI agent distribution**: See which AI platforms access your docs to learn which tools your users prefer.
-- **Integration opportunities**: Identify which AI platforms to prioritize for optimization and testing.
-- **AI traffic patterns**: Monitor which agents are most active and how their usage changes over time.
+The Agent section is available when your deployment has Advanced Analytics access. To view it, open [Analytics](https://app.mintlify.com/analytics) and select **Agent**. Use the date range selector to change the reporting period.
+
+Mintlify identifies agent visitors by IP address and user agent. The agent visitor count approximates distinct sources of AI traffic rather than individual agent sessions or conversations. Multiple requests from the same IP address count as one visitor.
## Assistant
diff --git a/zh/editor/settings.mdx b/zh/editor/settings.mdx
index 6207c2c822..aa9641e15e 100644
--- a/zh/editor/settings.mdx
+++ b/zh/editor/settings.mdx
@@ -4,12 +4,43 @@ description: "配置 AI 指令、pull request 默认值以及默认合并方式
keywords: ["编辑器", "设置", "ai", "指令", "发布", "pull request", "合并", "锁定分支"]
---
-Web 编辑器有两层设置:
+编辑器设置分为四个部分:
-- **个人设置**仅对你生效,控制编辑器的 AI 在你编辑时如何提供协助。
-- **发布设置**对部署中的所有人生效,决定变更在被提交并转换为 pull request 时如何处理。
+- **外观**和**聊天**仅对你生效。
+- **发布**对部署中的所有人都生效,并控制提交变更及将其转换为 pull request 时的处理方式。
+- **危险区域**包含可能丢弃未发布变更的操作。
-你可以在编辑器的 **Settings** 菜单中配置这两项。
+你可以在设置面板中配置这些选项。打开编辑器工具栏中的
设置图标,然后选择一个部分。
+
+
+ ## 外观
+
+
+外观设置控制你工作时编辑器的显示方式。这些偏好仅对你生效。
+
+
+ ### 让编辑器适应全宽
+
+
+当你需要更多水平空间来编辑宽内容或源文件时,启用 **Fit editor to full width**。编辑器会将编辑画布扩展到整个宽度,而不是使用默认的 768px 列宽。
+
+
+ ### 在新标签页中打开实时预览
+
+
+当你希望保持编辑器打开,同时在独立的浏览器标签页中查看渲染后的页面时,启用 **Open live preview in new tab**。预览网站时,Mintlify 会在新标签页中打开渲染后的页面。
+
+
+ ### 显示隐藏文件
+
+
+当你需要编辑点文件或其他隐藏文件时,启用 **Show hidden files**。Mintlify 会在导航侧边栏中显示这些文件。你也可以在 macOS 上按
⌘⇧.,或在其他平台上按
Ctrl+Shift+. 来切换此偏好设置。
+
+配置外观偏好设置:
+
+1. 点击编辑器工具栏中的
设置图标。
+2. 选择 **Appearance**。
+3. 打开或关闭偏好设置。
## AI 指令
diff --git a/zh/optimize/analytics.mdx b/zh/optimize/analytics.mdx
index 8241f007c9..88ebf6afc9 100644
--- a/zh/optimize/analytics.mdx
+++ b/zh/optimize/analytics.mdx
@@ -39,6 +39,21 @@ boost: 3
/>
+
+ ## 智能体
+
+
+**智能体**部分可帮助您了解 AI 智能体如何访问您的文档。该部分显示智能体和人类访客随时间变化的浏览量,并根据所选指标对页面或智能体进行排名。
+
+使用智能体分析可以:
+
+- **监控 AI 流量**:跟踪发布或更新内容后智能体流量的变化。
+- **查找智能体最常使用的页面**:在排名中选择 **Agent views**,找出 AI 工具经常访问的页面。
+- **识别活跃的智能体**:在排名中选择 **Agent visitors**,查看最常访问您文档的智能体。
+- **比较流量来源**:使用排名选择器比较人类浏览量、智能体浏览量、引荐来源和智能体访客数。
+
+当您的部署拥有 Advanced Analytics 访问权限时,可以使用**智能体**部分。要查看该部分,请打开[分析](https://app.mintlify.com/analytics)并选择 **Agent**。使用日期范围选择器更改报告时间段。
+
### 智能体浏览量
From 912c10d8de687c42d7aef48e59e2dbf41ceab929 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Wed, 5 Aug 2026 16:53:56 +0000
Subject: [PATCH 2/6] docs: polish agent analytics and editor settings
---
editor/settings.mdx | 4 ++--
es/editor/settings.mdx | 6 +++---
es/optimize/analytics.mdx | 20 +++++---------------
fr/editor/settings.mdx | 6 +++---
fr/optimize/analytics.mdx | 22 ++++++----------------
optimize/analytics.mdx | 10 +++++-----
zh/editor/settings.mdx | 11 +++++------
zh/optimize/analytics.mdx | 22 ++++++----------------
8 files changed, 35 insertions(+), 66 deletions(-)
diff --git a/editor/settings.mdx b/editor/settings.mdx
index 5bdf0c9597..0601f90423 100644
--- a/editor/settings.mdx
+++ b/editor/settings.mdx
@@ -1,6 +1,6 @@
---
-title: "Editor settings for AI and publishing"
-description: "Configure AI instructions, pull request defaults, and the default merge method to control how the Mintlify web editor publishes changes."
+title: "Editor settings for appearance, AI, and publishing"
+description: "Configure appearance preferences, AI instructions, pull request defaults, and merge methods in the Mintlify web editor to manage editing and publishing."
keywords: ["editor", "settings", "ai", "instructions", "publishing", "pull request", "merge", "lock branch"]
---
diff --git a/es/editor/settings.mdx b/es/editor/settings.mdx
index ba338864ab..cc9dc8acfb 100644
--- a/es/editor/settings.mdx
+++ b/es/editor/settings.mdx
@@ -1,6 +1,6 @@
---
-title: "Configuración del editor para IA y publicación"
-description: "Configure instrucciones de IA, valores por defecto de pull requests y el método de fusión que usa el editor web de Mintlify al publicar cambios."
+title: "Configuración del editor para apariencia, IA y publicación"
+description: "Configure las preferencias de apariencia, las instrucciones de IA, los valores de pull request y los métodos de fusión del editor web de Mintlify."
keywords: ["editor", "settings", "ai", "instructions", "publishing", "pull request", "merge", "lock branch"]
---
@@ -42,7 +42,7 @@ Active **Open live preview in new tab** cuando quiera mantener abierto el editor
-Active **Show hidden files** cuando necesite editar archivos de puntos u otros archivos ocultos. Mintlify los muestra en la barra lateral de navegación. También puede pulsar
⌘⇧. en macOS o
Ctrl+Shift+. en otras plataformas para alternar esta preferencia.
+Active **Show hidden files** cuando necesite editar archivos que empiezan por un punto u otros archivos ocultos. Mintlify los muestra en la barra lateral de navegación. También puede pulsar
⌘⇧. en macOS o
Ctrl+Shift+. en otras plataformas para alternar esta preferencia.
Para configurar una preferencia de apariencia:
diff --git a/es/optimize/analytics.mdx b/es/optimize/analytics.mdx
index 2649de8be6..8542cdfffb 100644
--- a/es/optimize/analytics.mdx
+++ b/es/optimize/analytics.mdx
@@ -1,6 +1,6 @@
---
-title: "Analíticas"
-description: "Consulta el tráfico, tendencias de búsqueda, uso del asistente y comentarios de los usuarios en el panel de analíticas de Mintlify para mejorar tu contenido."
+title: "Analíticas de tráfico, agentes, búsqueda y comentarios"
+description: "Consulta el tráfico, el uso de agentes y asistentes, las tendencias de búsqueda y los comentarios en las analíticas de Mintlify para mejorar tu contenido."
keywords: ["analytics","metrics","page views","traffic","trends","insights","impressions","CTA","call-to-action"]
boost: 3
---
@@ -48,24 +48,14 @@ La sección **Agentes** te ayuda a entender cómo los agentes de IA acceden a tu
Usa las analíticas de agentes para:
- **Supervisar el tráfico de IA**: realiza un seguimiento de los cambios en el tráfico de agentes después de publicar o actualizar contenido.
-- **Encontrar las páginas más utilizadas por los agentes**: selecciona **Agent views** en Clasificaciones para identificar las páginas a las que acceden con frecuencia las herramientas de IA.
-- **Identificar los agentes activos**: selecciona **Agent visitors** en Clasificaciones para ver qué agentes acceden a tu documentación con más frecuencia.
-- **Comparar fuentes de tráfico**: usa el selector de Clasificaciones para comparar vistas humanas, vistas de agentes, referencias y visitantes agentes.
+- **Encontrar las páginas más utilizadas por los agentes**: selecciona **Agent views** en **Rankings** para identificar las páginas a las que acceden con frecuencia las herramientas de IA.
+- **Identificar los agentes activos**: selecciona **Agent visitors** en **Rankings** para ver qué agentes acceden a tu documentación con más frecuencia.
+- **Comparar fuentes de tráfico**: usa el selector de **Rankings** para comparar **Human views**, **Agent views**, **Referrals** y **Agent visitors**.
La sección **Agentes** está disponible cuando tu deployment tiene acceso a Advanced Analytics. Para verla, abre [Analíticas](https://app.mintlify.com/analytics) y selecciona **Agent**. Usa el selector de intervalo de fechas para cambiar el periodo del informe.
-
- ### Vistas de agentes
-
-
Mintlify identifica a los visitantes agentes por dirección IP y user agent. El recuento de visitantes agentes aproxima las fuentes distintas de tráfico de IA en lugar de sesiones o conversaciones individuales de agentes. Múltiples solicitudes desde la misma dirección IP cuentan como un solo visitante.
-Utiliza las vistas de agentes para ayudar a determinar:
-
-- **Distribución de agentes de IA**: Observa qué plataformas de IA acceden a tus documentos para saber qué herramientas prefieren tus usuarios.
-- **Oportunidades de integración**: Identifica qué plataformas de IA priorizar para optimización y pruebas.
-- **Patrones de tráfico de IA**: Supervisa qué agentes son más activos y cómo cambia su uso a lo largo del tiempo.
-
## Asistente
diff --git a/fr/editor/settings.mdx b/fr/editor/settings.mdx
index b2ce67c7f4..d5effffe73 100644
--- a/fr/editor/settings.mdx
+++ b/fr/editor/settings.mdx
@@ -1,6 +1,6 @@
---
-title: "Paramètres de l'éditeur pour l'IA et la publication"
-description: "Configurez les instructions IA, les valeurs par défaut des pull requests et la méthode de fusion utilisée par l'éditeur web Mintlify pour publier."
+title: "Paramètres de l’éditeur pour l’apparence, l’IA et la publication"
+description: "Configurez les préférences d’apparence, les instructions IA, les valeurs par défaut des pull requests et les méthodes de fusion dans l’éditeur web Mintlify."
keywords: ["editor", "settings", "ai", "instructions", "publishing", "pull request", "merge", "lock branch"]
---
@@ -42,7 +42,7 @@ Activez **Open live preview in new tab** lorsque vous voulez garder l'éditeur o
-Activez **Show hidden files** lorsque vous devez modifier des fichiers dot ou d'autres fichiers masqués. Mintlify les affiche dans la barre latérale de navigation. Vous pouvez aussi appuyer sur
⌘⇧. sur macOS ou
Ctrl+Shift+. sur les autres plateformes pour activer ou désactiver cette préférence.
+Activez **Show hidden files** lorsque vous devez modifier des fichiers commençant par un point ou d'autres fichiers masqués. Mintlify les affiche dans la barre latérale de navigation. Vous pouvez aussi appuyer sur
⌘⇧. sur macOS ou
Ctrl+Shift+. sur les autres plateformes pour activer ou désactiver cette préférence.
Pour configurer une préférence d'apparence :
diff --git a/fr/optimize/analytics.mdx b/fr/optimize/analytics.mdx
index ae624ddcae..eb6a50f449 100644
--- a/fr/optimize/analytics.mdx
+++ b/fr/optimize/analytics.mdx
@@ -1,6 +1,6 @@
---
-title: "Analytique"
-description: "Suivez le trafic, les tendances de recherche, l'utilisation de l'assistant et les retours des utilisateurs dans le tableau de bord d'analytique Mintlify."
+title: "Analytique du trafic, des agents et des recherches"
+description: "Suivez le trafic, l’usage des agents, les tendances de recherche, l’utilisation de l’assistant et les retours dans le tableau de bord Mintlify."
keywords: ["analytics","metrics","page views","traffic","trends","insights","impressions","CTA","call-to-action"]
boost: 3
---
@@ -48,24 +48,14 @@ La section **Agents** vous aide à comprendre comment les agents IA accèdent à
Utilisez les analyses des agents pour :
- **Surveiller le trafic IA** : suivez l'évolution du trafic des agents après la publication ou la mise à jour de contenu.
-- **Trouver les pages les plus utilisées par les agents** : sélectionnez **Agent views** dans Classements pour identifier les contenus auxquels les outils IA accèdent fréquemment.
-- **Identifier les agents actifs** : sélectionnez **Agent visitors** dans Classements pour voir quels agents accèdent le plus souvent à votre documentation.
-- **Comparer les sources de trafic** : utilisez le sélecteur Classements pour comparer les vues humaines, les vues des agents, les recommandations et les visiteurs agents.
+- **Trouver les pages les plus utilisées par les agents** : sélectionnez **Agent views** dans **Rankings** pour identifier les contenus auxquels les outils IA accèdent fréquemment.
+- **Identifier les agents actifs** : sélectionnez **Agent visitors** dans **Rankings** pour voir quels agents accèdent le plus souvent à votre documentation.
+- **Comparer les sources de trafic** : utilisez le sélecteur **Rankings** pour comparer **Human views**, **Agent views**, **Referrals** et **Agent visitors**.
-La section **Agents** est disponible lorsque votre déploiement dispose de l'accès à Advanced Analytics. Pour l'afficher, ouvrez [Analytics](https://app.mintlify.com/analytics) et sélectionnez **Agent**. Utilisez le sélecteur de plage de dates pour modifier la période du rapport.
-
-
- ### Vues des agents
-
+La section **Agents** est disponible lorsque votre déploiement dispose d'un accès à Advanced Analytics. Pour l'afficher, ouvrez [Analytics](https://app.mintlify.com/analytics) et sélectionnez **Agent**. Utilisez le sélecteur de plage de dates pour modifier la période du rapport.
Mintlify identifie les visiteurs agents par adresse IP et user agent. Le nombre de visiteurs agents estime les sources distinctes de trafic IA plutôt que les sessions ou conversations individuelles d'agents. Plusieurs requêtes provenant de la même adresse IP comptent comme un seul visiteur.
-Utilisez les vues des agents pour vous aider à déterminer :
-
-- **Répartition des agents IA** : voyez quelles plateformes d'IA accèdent à votre documentation pour découvrir quels outils vos utilisateurs préfèrent.
-- **Opportunités d'intégration** : identifiez les plateformes d'IA à prioriser pour l'optimisation et les tests.
-- **Modèles de trafic IA** : surveillez quels agents sont les plus actifs et comment leur utilisation évolue au fil du temps.
-
## Assistant
diff --git a/optimize/analytics.mdx b/optimize/analytics.mdx
index 896e4345e6..8f7179f0b3 100644
--- a/optimize/analytics.mdx
+++ b/optimize/analytics.mdx
@@ -1,6 +1,6 @@
---
-title: "Analytics"
-description: "Track traffic, search trends, assistant usage, and user feedback in the Mintlify analytics dashboard to improve content and report on effectiveness."
+title: "Analytics for traffic, AI agents, search, and feedback"
+description: "Track traffic, AI agent usage, search trends, assistant activity, and user feedback in the Mintlify analytics dashboard to improve documentation."
keywords: ["analytics","metrics","page views","traffic","trends","insights","impressions","CTA","call-to-action"]
boost: 3
---
@@ -44,9 +44,9 @@ The Agent section helps you understand how AI agents access your documentation.
Use Agent analytics when you want to:
- **Monitor AI traffic**: Track changes in agent traffic after you publish or update content.
-- **Find pages agents use most**: Select **Agent views** in Rankings to identify the pages that AI tools access frequently.
-- **Identify active agents**: Select **Agent visitors** in Rankings to see which agents access your documentation most often.
-- **Compare traffic sources**: Use the Rankings selector to compare agent views, human views, referrals, and agent visitors.
+- **Find pages agents use most**: Select **Agent views** in **Rankings** to identify the pages that AI tools access frequently.
+- **Identify active agents**: Select **Agent visitors** in **Rankings** to see which agents access your documentation most often.
+- **Compare traffic sources**: Use the **Rankings** selector to compare **Human views**, **Agent views**, **Referrals**, and **Agent visitors**.
The Agent section is available when your deployment has Advanced Analytics access. To view it, open [Analytics](https://app.mintlify.com/analytics) and select **Agent**. Use the date range selector to change the reporting period.
diff --git a/zh/editor/settings.mdx b/zh/editor/settings.mdx
index aa9641e15e..5765a50c69 100644
--- a/zh/editor/settings.mdx
+++ b/zh/editor/settings.mdx
@@ -1,6 +1,6 @@
---
-title: "用于 AI 与发布的编辑器设置"
-description: "配置 AI 指令、pull request 默认值以及默认合并方式,以控制 Mintlify Web 编辑器发布变更的方式。"
+title: "编辑器外观、AI 与发布设置"
+description: "在 Mintlify Web 编辑器中配置外观偏好、AI 指令、pull request 默认值和合并方式,以控制编辑器的显示与发布行为。"
keywords: ["编辑器", "设置", "ai", "指令", "发布", "pull request", "合并", "锁定分支"]
---
@@ -72,10 +72,9 @@ AI 指令是编辑器随你的请求一起发送给 AI 的持续生效指令。
### 配置 AI 指令
-1. 打开编辑器,点击工具栏中的头像。
-2. 选择 **Settings**。
-3. 在 **AI instructions** 字段中输入希望 AI 遵循的指令。
-4. 保存更改。
+1. 点击编辑器工具栏中的
## 助手
From 3bc7f88a06f08ea17d44346909b784d9d1f44714 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Wed, 5 Aug 2026 18:18:08 +0000
Subject: [PATCH 3/6] docs: update agent analytics navigation
---
es/optimize/analytics.mdx | 24 +++++++-----------------
fr/optimize/analytics.mdx | 24 +++++++-----------------
optimize/analytics.mdx | 22 +++++++---------------
zh/optimize/analytics.mdx | 24 +++++++-----------------
4 files changed, 28 insertions(+), 66 deletions(-)
diff --git a/es/optimize/analytics.mdx b/es/optimize/analytics.mdx
index 8542cdfffb..7b2096b2a0 100644
--- a/es/optimize/analytics.mdx
+++ b/es/optimize/analytics.mdx
@@ -25,6 +25,13 @@ Revisa tus analíticas de tráfico para:
- **Identificar páginas populares**: Utiliza las páginas mejor clasificadas para comprender qué contenido es más importante para tus usuarios y así asegurarte de que esté actualizado y sea completo.
- **Rastrear fuentes de referencia**: Comprende de dónde provienen tus usuarios para ayudarte a optimizar tu contenido para la audiencia adecuada.
+La sección **Traffic Overview** incluye una tarjeta **Rankings**. Usa su selector de métricas para comparar **Human views**, **Agent views**, **Referrals** y **Agent visitors**.
+
+- **Encontrar las páginas más utilizadas por los agentes**: selecciona **Agent views** en **Rankings** para identificar las páginas a las que acceden con frecuencia las herramientas de IA.
+- **Identificar los agentes activos**: selecciona **Agent visitors** en **Rankings** para ver qué agentes acceden a tu documentación con más frecuencia.
+
+Mintlify identifica a los visitantes agentes por dirección IP y user agent. El recuento de visitantes agentes aproxima las fuentes distintas de tráfico de IA en lugar de sesiones o conversaciones individuales de agentes. Múltiples solicitudes desde la misma dirección IP cuentan como un solo visitante.
+

-
- ## Agentes
-
-
-La sección **Agentes** te ayuda a entender cómo los agentes de IA acceden a tu documentación. Muestra las vistas de agentes y humanas a lo largo del tiempo y clasifica las páginas o los agentes según la métrica seleccionada.
-
-Usa las analíticas de agentes para:
-
-- **Supervisar el tráfico de IA**: realiza un seguimiento de los cambios en el tráfico de agentes después de publicar o actualizar contenido.
-- **Encontrar las páginas más utilizadas por los agentes**: selecciona **Agent views** en **Rankings** para identificar las páginas a las que acceden con frecuencia las herramientas de IA.
-- **Identificar los agentes activos**: selecciona **Agent visitors** en **Rankings** para ver qué agentes acceden a tu documentación con más frecuencia.
-- **Comparar fuentes de tráfico**: usa el selector de **Rankings** para comparar **Human views**, **Agent views**, **Referrals** y **Agent visitors**.
-
-La sección **Agentes** está disponible cuando tu deployment tiene acceso a Advanced Analytics. Para verla, abre [Analíticas](https://app.mintlify.com/analytics) y selecciona **Agent**. Usa el selector de intervalo de fechas para cambiar el periodo del informe.
-
-Mintlify identifica a los visitantes agentes por dirección IP y user agent. El recuento de visitantes agentes aproxima las fuentes distintas de tráfico de IA en lugar de sesiones o conversaciones individuales de agentes. Múltiples solicitudes desde la misma dirección IP cuentan como un solo visitante.
-
## Asistente
diff --git a/fr/optimize/analytics.mdx b/fr/optimize/analytics.mdx
index eb6a50f449..addf1332b7 100644
--- a/fr/optimize/analytics.mdx
+++ b/fr/optimize/analytics.mdx
@@ -25,6 +25,13 @@ Examinez vos analyses de trafic pour :
- **Identifier les pages populaires** : utilisez les pages les mieux classées pour comprendre quels contenus sont les plus importants pour vos utilisateurs afin de vous assurer qu'ils restent à jour et complets.
- **Suivre les sources de référence** : comprenez d'où viennent vos utilisateurs pour vous aider à optimiser votre contenu pour la bonne audience.
+La section **Traffic Overview** comprend une carte **Rankings**. Utilisez son sélecteur de métrique pour comparer **Human views**, **Agent views**, **Referrals** et **Agent visitors**.
+
+- **Trouver les pages les plus utilisées par les agents** : sélectionnez **Agent views** dans **Rankings** pour identifier les contenus auxquels les outils IA accèdent fréquemment.
+- **Identifier les agents actifs** : sélectionnez **Agent visitors** dans **Rankings** pour voir quels agents accèdent le plus souvent à votre documentation.
+
+Mintlify identifie les visiteurs agents par adresse IP et user agent. Le nombre de visiteurs agents estime les sources distinctes de trafic IA plutôt que les sessions ou conversations individuelles d'agents. Plusieurs requêtes provenant de la même adresse IP comptent comme un seul visiteur.
+

-
- ## Agents
-
-
-La section **Agents** vous aide à comprendre comment les agents IA accèdent à votre documentation. Elle affiche les vues des agents et des humains au fil du temps et classe les pages ou les agents selon la métrique sélectionnée.
-
-Utilisez les analyses des agents pour :
-
-- **Surveiller le trafic IA** : suivez l'évolution du trafic des agents après la publication ou la mise à jour de contenu.
-- **Trouver les pages les plus utilisées par les agents** : sélectionnez **Agent views** dans **Rankings** pour identifier les contenus auxquels les outils IA accèdent fréquemment.
-- **Identifier les agents actifs** : sélectionnez **Agent visitors** dans **Rankings** pour voir quels agents accèdent le plus souvent à votre documentation.
-- **Comparer les sources de trafic** : utilisez le sélecteur **Rankings** pour comparer **Human views**, **Agent views**, **Referrals** et **Agent visitors**.
-
-La section **Agents** est disponible lorsque votre déploiement dispose d'un accès à Advanced Analytics. Pour l'afficher, ouvrez [Analytics](https://app.mintlify.com/analytics) et sélectionnez **Agent**. Utilisez le sélecteur de plage de dates pour modifier la période du rapport.
-
-Mintlify identifie les visiteurs agents par adresse IP et user agent. Le nombre de visiteurs agents estime les sources distinctes de trafic IA plutôt que les sessions ou conversations individuelles d'agents. Plusieurs requêtes provenant de la même adresse IP comptent comme un seul visiteur.
-
## Assistant
diff --git a/optimize/analytics.mdx b/optimize/analytics.mdx
index 8f7179f0b3..a749f5cabe 100644
--- a/optimize/analytics.mdx
+++ b/optimize/analytics.mdx
@@ -23,6 +23,13 @@ Review your traffic analytics to:
- **Identify popular pages**: Use highly ranked pages to understand what content is most important to your users. Keep those pages up to date and comprehensive.
- **Track referral sources**: Understand where your users are coming from to help you optimize your content for the right audience.
+The **Traffic Overview** section includes a **Rankings** card. Use its metric selector to compare **Human views**, **Agent views**, **Referrals**, and **Agent visitors**.
+
+- **Find pages agents use most**: Select **Agent views** in **Rankings** to identify the pages that AI tools access frequently.
+- **Identify active agents**: Select **Agent visitors** in **Rankings** to see which agents access your documentation most often.
+
+Mintlify identifies agent visitors by IP address and user agent. The agent visitor count approximates distinct sources of AI traffic rather than individual agent sessions or conversations. Multiple requests from the same IP address count as one visitor.
+

-## Agent
-
-The Agent section helps you understand how AI agents access your documentation. It shows agent and human views over time and ranks pages or agents by the selected metric.
-
-Use Agent analytics when you want to:
-
-- **Monitor AI traffic**: Track changes in agent traffic after you publish or update content.
-- **Find pages agents use most**: Select **Agent views** in **Rankings** to identify the pages that AI tools access frequently.
-- **Identify active agents**: Select **Agent visitors** in **Rankings** to see which agents access your documentation most often.
-- **Compare traffic sources**: Use the **Rankings** selector to compare **Human views**, **Agent views**, **Referrals**, and **Agent visitors**.
-
-The Agent section is available when your deployment has Advanced Analytics access. To view it, open [Analytics](https://app.mintlify.com/analytics) and select **Agent**. Use the date range selector to change the reporting period.
-
-Mintlify identifies agent visitors by IP address and user agent. The agent visitor count approximates distinct sources of AI traffic rather than individual agent sessions or conversations. Multiple requests from the same IP address count as one visitor.
-
## Assistant
The assistant section of the analytics page displays assistant usage over time and chat history.
diff --git a/zh/optimize/analytics.mdx b/zh/optimize/analytics.mdx
index 942482a4ce..28586aa22d 100644
--- a/zh/optimize/analytics.mdx
+++ b/zh/optimize/analytics.mdx
@@ -25,6 +25,13 @@ boost: 3
- **识别热门页面**:通过排名靠前的页面了解哪些内容对用户最重要,从而确保这些内容保持最新且完整全面。
- **跟踪引荐来源**:了解用户来自何处,帮助您针对合适的受众优化内容。
+**Traffic Overview** 部分包含 **Rankings** 卡片。使用其中的指标选择器比较 **Human views**、**Agent views**、**Referrals** 和 **Agent visitors**。
+
+- **查找智能体最常使用的页面**:在 **Rankings** 中选择 **Agent views**,找出 AI 工具经常访问的页面。
+- **识别活跃的智能体**:在 **Rankings** 中选择 **Agent visitors**,查看最常访问您文档的智能体。
+
+Mintlify 通过 IP 地址和用户代理来识别智能体访客。智能体访客计数近似地反映了不同的 AI 流量来源,而非单个智能体会话或对话。来自同一 IP 地址的多次请求计为一位访客。
+

-
- ## 智能体
-
-
-**智能体**部分可帮助您了解 AI 智能体如何访问您的文档。该部分显示智能体和人类访客随时间变化的浏览量,并根据所选指标对页面或智能体进行排名。
-
-使用智能体分析可以:
-
-- **监控 AI 流量**:跟踪发布或更新内容后智能体流量的变化。
-- **查找智能体最常使用的页面**:在 **Rankings** 中选择 **Agent views**,找出 AI 工具经常访问的页面。
-- **识别活跃的智能体**:在 **Rankings** 中选择 **Agent visitors**,查看最常访问您文档的智能体。
-- **比较流量来源**:使用 **Rankings** 选择器比较 **Human views**、**Agent views**、**Referrals** 和 **Agent visitors**。
-
-当您的部署拥有 Advanced Analytics 访问权限时,可以使用**智能体**部分。要查看该部分,请打开[分析](https://app.mintlify.com/analytics)并选择 **Agent**。使用日期范围选择器更改报告时间段。
-
-Mintlify 通过 IP 地址和用户代理来识别智能体访客。智能体访客计数近似地反映了不同的 AI 流量来源,而非单个智能体会话或对话。来自同一 IP 地址的多次请求计为一位访客。
-
## 助手
From 2f6f4e0ecc0f097b2ca96bb3b05eb61d49810e5f Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Wed, 5 Aug 2026 18:21:50 +0000
Subject: [PATCH 4/6] docs: polish translated analytics metadata
---
fr/editor/settings.mdx | 2 +-
zh/editor/settings.mdx | 2 +-
zh/optimize/analytics.mdx | 2 +-
3 files changed, 3 insertions(+), 3 deletions(-)
diff --git a/fr/editor/settings.mdx b/fr/editor/settings.mdx
index d5effffe73..5222f95acb 100644
--- a/fr/editor/settings.mdx
+++ b/fr/editor/settings.mdx
@@ -1,5 +1,5 @@
---
-title: "Paramètres de l’éditeur pour l’apparence, l’IA et la publication"
+title: "Paramètres de l’éditeur : apparence, IA et publication"
description: "Configurez les préférences d’apparence, les instructions IA, les valeurs par défaut des pull requests et les méthodes de fusion dans l’éditeur web Mintlify."
keywords: ["editor", "settings", "ai", "instructions", "publishing", "pull request", "merge", "lock branch"]
---
diff --git a/zh/editor/settings.mdx b/zh/editor/settings.mdx
index 5765a50c69..e2696bfdaf 100644
--- a/zh/editor/settings.mdx
+++ b/zh/editor/settings.mdx
@@ -1,6 +1,6 @@
---
title: "编辑器外观、AI 与发布设置"
-description: "在 Mintlify Web 编辑器中配置外观偏好、AI 指令、pull request 默认值和合并方式,以控制编辑器的显示与发布行为。"
+description: "在 Mintlify Web 编辑器中配置外观偏好、AI 指令、pull request 默认值和合并方式,管理编辑体验、编辑器行为、提交变更以及发布流程,并了解如何安全处理未发布的修改、调整编辑器布局和查看实时预览,并掌握外观、聊天、发布和危险区域设置的作用。"
keywords: ["编辑器", "设置", "ai", "指令", "发布", "pull request", "合并", "锁定分支"]
---
diff --git a/zh/optimize/analytics.mdx b/zh/optimize/analytics.mdx
index 28586aa22d..e6f3ff9e62 100644
--- a/zh/optimize/analytics.mdx
+++ b/zh/optimize/analytics.mdx
@@ -1,6 +1,6 @@
---
title: "流量、智能体和搜索分析"
-description: "在 Mintlify 分析仪表板中跟踪网站流量、AI 智能体访问、搜索趋势、助手使用情况和用户反馈,以改进文档内容并评估效果。"
+description: "在 Mintlify 分析仪表板中跟踪流量、AI 智能体访问、搜索趋势、助手使用情况和用户反馈,以改进文档内容、发现热门页面并评估效果。使用 Traffic Overview 的 Rankings 指标比较 Human views、Agent views、Referrals 和 Agent visitors。"
keywords: ["analytics","metrics","page views","traffic","trends","insights","impressions","CTA","call-to-action"]
boost: 3
---
From 28d3b47c38042b173469810392c8c69295742fae Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Wed, 5 Aug 2026 19:03:38 +0000
Subject: [PATCH 5/6] docs: update reverted analytics and settings navigation
---
editor/settings.mdx | 8 ++++----
es/editor/settings.mdx | 10 +++++-----
es/optimize/analytics.mdx | 2 +-
fr/editor/settings.mdx | 10 +++++-----
fr/optimize/analytics.mdx | 2 +-
optimize/analytics.mdx | 2 +-
zh/editor/settings.mdx | 10 +++++-----
zh/optimize/analytics.mdx | 4 ++--
8 files changed, 24 insertions(+), 24 deletions(-)
diff --git a/editor/settings.mdx b/editor/settings.mdx
index 0601f90423..b08b4014ec 100644
--- a/editor/settings.mdx
+++ b/editor/settings.mdx
@@ -10,7 +10,7 @@ The web editor groups settings into four sections:
- **Publishing** applies to everyone on a deployment and controls what happens when you commit changes and turn them into pull requests.
- **Danger zone** contains actions that can discard unpublished changes.
-You can configure these settings from the settings panel. To open it, click the
settings icon in the editor toolbar, then select a section.
+You can configure these settings from the settings panel. To open it, click the
settings icon in the editor toolbar. The settings page displays all four sections.
## Appearance
@@ -24,14 +24,14 @@ Enable **Fit editor to full width** when you need more horizontal space for wide
Enable **Open live preview in new tab** when you want to keep the editor open while viewing the rendered page in a separate browser tab. When you preview your site, Mintlify opens the rendered page in a new tab.
-### Show hidden files
+### Show all files
-Enable **Show hidden files** when you need to edit dotfiles or other hidden files. Mintlify displays them in the navigation sidebar. You can also press
⌘⇧. on macOS or
Ctrl+Shift+. on other platforms to toggle this preference.
+Enable **Show all files** to display dotfiles, code, PDFs, and other files that are hidden by default. Mintlify displays them in the navigation sidebar. You can also press
⌘⇧. on macOS or
Ctrl+Shift+. on other platforms to toggle this preference.
To configure an appearance preference:
1. Click the
settings icon in the editor toolbar.
-2. Select **Appearance**.
+2. Find or scroll to **Appearance**.
3. Turn the preference on or off.
## AI instructions
diff --git a/es/editor/settings.mdx b/es/editor/settings.mdx
index cc9dc8acfb..9c3d0f67b2 100644
--- a/es/editor/settings.mdx
+++ b/es/editor/settings.mdx
@@ -10,7 +10,7 @@ La configuración del editor se divide en cuatro secciones:
- **Publicación** se aplica a todos en un deployment y controla qué sucede cuando confirma cambios y los convierte en pull requests.
- **Zona de peligro** contiene acciones que pueden descartar cambios sin publicar.
-Puede configurar estos ajustes desde el panel de configuración. Para abrirlo, haga clic en el icono
de configuración en la barra de herramientas del editor y seleccione una sección.
+Puede configurar estos ajustes desde el panel de configuración. Para abrirlo, haga clic en el icono
de configuración en la barra de herramientas del editor. La página de configuración muestra las cuatro secciones.
@@ -36,18 +36,18 @@ Active **Fit editor to full width** cuando necesite más espacio horizontal para
Active **Open live preview in new tab** cuando quiera mantener abierto el editor mientras ve la página renderizada en una pestaña independiente del navegador. Al obtener una vista previa del sitio, Mintlify abre la página renderizada en una pestaña nueva.
-
+
-### Mostrar archivos ocultos
+### Mostrar todos los archivos
-Active **Show hidden files** cuando necesite editar archivos que empiezan por un punto u otros archivos ocultos. Mintlify los muestra en la barra lateral de navegación. También puede pulsar
⌘⇧. en macOS o
Ctrl+Shift+. en otras plataformas para alternar esta preferencia.
+Active **Show all files** para mostrar los archivos que comienzan por un punto, los archivos de código, los archivos PDF y otros archivos ocultos de forma predeterminada. Mintlify los muestra en la barra lateral de navegación. También puede pulsar
⌘⇧. en macOS o
Ctrl+Shift+. en otras plataformas para alternar esta preferencia.
Para configurar una preferencia de apariencia:
1. Haga clic en el icono
de configuración en la barra de herramientas del editor.
-2. Seleccione **Appearance**.
+2. Busque la sección **Appearance** o desplácese hasta ella.
3. Active o desactive la preferencia.
diff --git a/es/optimize/analytics.mdx b/es/optimize/analytics.mdx
index 7b2096b2a0..9d2f16acce 100644
--- a/es/optimize/analytics.mdx
+++ b/es/optimize/analytics.mdx
@@ -25,7 +25,7 @@ Revisa tus analíticas de tráfico para:
- **Identificar páginas populares**: Utiliza las páginas mejor clasificadas para comprender qué contenido es más importante para tus usuarios y así asegurarte de que esté actualizado y sea completo.
- **Rastrear fuentes de referencia**: Comprende de dónde provienen tus usuarios para ayudarte a optimizar tu contenido para la audiencia adecuada.
-La sección **Traffic Overview** incluye una tarjeta **Rankings**. Usa su selector de métricas para comparar **Human views**, **Agent views**, **Referrals** y **Agent visitors**.
+La sección **Traffic** incluye una tarjeta **Rankings**. Usa su selector de métricas para comparar **Human views**, **Agent views**, **Referrals** y **Agent visitors**.
- **Encontrar las páginas más utilizadas por los agentes**: selecciona **Agent views** en **Rankings** para identificar las páginas a las que acceden con frecuencia las herramientas de IA.
- **Identificar los agentes activos**: selecciona **Agent visitors** en **Rankings** para ver qué agentes acceden a tu documentación con más frecuencia.
diff --git a/fr/editor/settings.mdx b/fr/editor/settings.mdx
index 5222f95acb..74d4058798 100644
--- a/fr/editor/settings.mdx
+++ b/fr/editor/settings.mdx
@@ -10,7 +10,7 @@ Les paramètres de l'éditeur sont regroupés en quatre sections :
- **Publication** s'applique à toutes les personnes d'un déploiement et contrôle ce qui se passe lorsque vous validez des modifications et les transformez en pull requests.
- La **zone dangereuse** contient des actions qui peuvent supprimer des modifications non publiées.
-Vous pouvez configurer ces paramètres depuis le panneau des paramètres. Pour l'ouvrir, cliquez sur l'icône de paramètres
dans la barre d'outils de l'éditeur, puis sélectionnez une section.
+Vous pouvez configurer ces paramètres depuis le panneau des paramètres. Pour l'ouvrir, cliquez sur l'icône de paramètres
dans la barre d'outils de l'éditeur. La page des paramètres affiche les quatre sections.
@@ -36,18 +36,18 @@ Activez **Fit editor to full width** lorsque vous avez besoin de plus d'espace h
Activez **Open live preview in new tab** lorsque vous voulez garder l'éditeur ouvert tout en affichant la page rendue dans un onglet distinct du navigateur. Lorsque vous prévisualisez votre site, Mintlify ouvre la page rendue dans un nouvel onglet.
-
+
-### Afficher les fichiers masqués
+### Afficher tous les fichiers
-Activez **Show hidden files** lorsque vous devez modifier des fichiers commençant par un point ou d'autres fichiers masqués. Mintlify les affiche dans la barre latérale de navigation. Vous pouvez aussi appuyer sur
⌘⇧. sur macOS ou
Ctrl+Shift+. sur les autres plateformes pour activer ou désactiver cette préférence.
+Activez **Show all files** pour afficher les fichiers commençant par un point, les fichiers de code, les PDF et les autres fichiers masqués par défaut. Mintlify les affiche dans la barre latérale de navigation. Vous pouvez aussi appuyer sur
⌘⇧. sur macOS ou
Ctrl+Shift+. sur les autres plateformes pour activer ou désactiver cette préférence.
Pour configurer une préférence d'apparence :
1. Cliquez sur l'icône de paramètres
dans la barre d'outils de l'éditeur.
-2. Sélectionnez **Appearance**.
+2. Repérez la section **Appearance** ou faites défiler la page jusqu'à celle-ci.
3. Activez ou désactivez la préférence.
diff --git a/fr/optimize/analytics.mdx b/fr/optimize/analytics.mdx
index addf1332b7..e4a750a6f3 100644
--- a/fr/optimize/analytics.mdx
+++ b/fr/optimize/analytics.mdx
@@ -25,7 +25,7 @@ Examinez vos analyses de trafic pour :
- **Identifier les pages populaires** : utilisez les pages les mieux classées pour comprendre quels contenus sont les plus importants pour vos utilisateurs afin de vous assurer qu'ils restent à jour et complets.
- **Suivre les sources de référence** : comprenez d'où viennent vos utilisateurs pour vous aider à optimiser votre contenu pour la bonne audience.
-La section **Traffic Overview** comprend une carte **Rankings**. Utilisez son sélecteur de métrique pour comparer **Human views**, **Agent views**, **Referrals** et **Agent visitors**.
+La section **Traffic** comprend une carte **Rankings**. Utilisez son sélecteur de métrique pour comparer **Human views**, **Agent views**, **Referrals** et **Agent visitors**.
- **Trouver les pages les plus utilisées par les agents** : sélectionnez **Agent views** dans **Rankings** pour identifier les contenus auxquels les outils IA accèdent fréquemment.
- **Identifier les agents actifs** : sélectionnez **Agent visitors** dans **Rankings** pour voir quels agents accèdent le plus souvent à votre documentation.
diff --git a/optimize/analytics.mdx b/optimize/analytics.mdx
index a749f5cabe..7b9da3d38f 100644
--- a/optimize/analytics.mdx
+++ b/optimize/analytics.mdx
@@ -23,7 +23,7 @@ Review your traffic analytics to:
- **Identify popular pages**: Use highly ranked pages to understand what content is most important to your users. Keep those pages up to date and comprehensive.
- **Track referral sources**: Understand where your users are coming from to help you optimize your content for the right audience.
-The **Traffic Overview** section includes a **Rankings** card. Use its metric selector to compare **Human views**, **Agent views**, **Referrals**, and **Agent visitors**.
+The **Traffic** section includes a **Rankings** card. Use its metric selector to compare **Human views**, **Agent views**, **Referrals**, and **Agent visitors**.
- **Find pages agents use most**: Select **Agent views** in **Rankings** to identify the pages that AI tools access frequently.
- **Identify active agents**: Select **Agent visitors** in **Rankings** to see which agents access your documentation most often.
diff --git a/zh/editor/settings.mdx b/zh/editor/settings.mdx
index e2696bfdaf..9dafedfaf2 100644
--- a/zh/editor/settings.mdx
+++ b/zh/editor/settings.mdx
@@ -10,7 +10,7 @@ keywords: ["编辑器", "设置", "ai", "指令", "发布", "pull request", "合
- **发布**对部署中的所有人都生效,并控制提交变更及将其转换为 pull request 时的处理方式。
- **危险区域**包含可能丢弃未发布变更的操作。
-你可以在设置面板中配置这些选项。打开编辑器工具栏中的
设置图标,然后选择一个部分。
+你可以在设置面板中配置这些选项。打开编辑器工具栏中的
设置图标。设置页面会显示全部四个部分。
## 外观
@@ -30,16 +30,16 @@ keywords: ["编辑器", "设置", "ai", "指令", "发布", "pull request", "合
当你希望保持编辑器打开,同时在独立的浏览器标签页中查看渲染后的页面时,启用 **Open live preview in new tab**。预览网站时,Mintlify 会在新标签页中打开渲染后的页面。
-
- ### 显示隐藏文件
+
+ ### 显示所有文件
-当你需要编辑点文件或其他隐藏文件时,启用 **Show hidden files**。Mintlify 会在导航侧边栏中显示这些文件。你也可以在 macOS 上按
⌘⇧.,或在其他平台上按
Ctrl+Shift+. 来切换此偏好设置。
+启用 **Show all files** 可显示点文件、代码、PDF 以及默认隐藏的其他文件。Mintlify 会在导航侧边栏中显示这些文件。你也可以在 macOS 上按
⌘⇧.,或在其他平台上按
Ctrl+Shift+. 来切换此偏好设置。
配置外观偏好设置:
1. 点击编辑器工具栏中的
设置图标。
-2. 选择 **Appearance**。
+2. 找到 **Appearance** 部分,或滚动到该部分。
3. 打开或关闭偏好设置。
diff --git a/zh/optimize/analytics.mdx b/zh/optimize/analytics.mdx
index e6f3ff9e62..548e9a8486 100644
--- a/zh/optimize/analytics.mdx
+++ b/zh/optimize/analytics.mdx
@@ -1,6 +1,6 @@
---
title: "流量、智能体和搜索分析"
-description: "在 Mintlify 分析仪表板中跟踪流量、AI 智能体访问、搜索趋势、助手使用情况和用户反馈,以改进文档内容、发现热门页面并评估效果。使用 Traffic Overview 的 Rankings 指标比较 Human views、Agent views、Referrals 和 Agent visitors。"
+description: "在 Mintlify 分析仪表板中跟踪流量、AI 智能体访问、搜索趋势、助手使用情况和用户反馈,以改进文档内容、发现热门页面并评估效果。使用 Traffic 的 Rankings 指标比较 Human views、Agent views、Referrals 和 Agent visitors。"
keywords: ["analytics","metrics","page views","traffic","trends","insights","impressions","CTA","call-to-action"]
boost: 3
---
@@ -25,7 +25,7 @@ boost: 3
- **识别热门页面**:通过排名靠前的页面了解哪些内容对用户最重要,从而确保这些内容保持最新且完整全面。
- **跟踪引荐来源**:了解用户来自何处,帮助您针对合适的受众优化内容。
-**Traffic Overview** 部分包含 **Rankings** 卡片。使用其中的指标选择器比较 **Human views**、**Agent views**、**Referrals** 和 **Agent visitors**。
+**Traffic** 部分包含 **Rankings** 卡片。使用其中的指标选择器比较 **Human views**、**Agent views**、**Referrals** 和 **Agent visitors**。
- **查找智能体最常使用的页面**:在 **Rankings** 中选择 **Agent views**,找出 AI 工具经常访问的页面。
- **识别活跃的智能体**:在 **Rankings** 中选择 **Agent visitors**,查看最常访问您文档的智能体。
From 72e2360f5bba20186225f435f26d396b3e959802 Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Mon, 10 Aug 2026 11:03:14 -0700
Subject: [PATCH 6/6] fix conflicts
---
editor/settings.mdx | 2 +-
es/optimize/analytics.mdx | 23 +++++++++++++++--------
fr/optimize/analytics.mdx | 23 +++++++++++++++--------
optimize/analytics.mdx | 21 +++++++++++++--------
zh/editor/settings.mdx | 2 +-
zh/optimize/analytics.mdx | 23 +++++++++++++++--------
6 files changed, 60 insertions(+), 34 deletions(-)
diff --git a/editor/settings.mdx b/editor/settings.mdx
index b08b4014ec..a89d0f9f51 100644
--- a/editor/settings.mdx
+++ b/editor/settings.mdx
@@ -26,7 +26,7 @@ Enable **Open live preview in new tab** when you want to keep the editor open wh
### Show all files
-Enable **Show all files** to display dotfiles, code, PDFs, and other files that are hidden by default. Mintlify displays them in the navigation sidebar. You can also press
⌘⇧. on macOS or
Ctrl+Shift+. on other platforms to toggle this preference.
+Enable **Show all files** to display every file in the navigation sidebar, including files whose names begin with a period, code, and PDFs. You can also press
⌘⇧. on macOS or
Ctrl+Shift+. on other platforms to toggle this preference.
To configure an appearance preference:
diff --git a/es/optimize/analytics.mdx b/es/optimize/analytics.mdx
index 9d2f16acce..43d19f4c43 100644
--- a/es/optimize/analytics.mdx
+++ b/es/optimize/analytics.mdx
@@ -1,6 +1,6 @@
---
-title: "Analíticas de tráfico, agentes, búsqueda y comentarios"
-description: "Consulta el tráfico, el uso de agentes y asistentes, las tendencias de búsqueda y los comentarios en las analíticas de Mintlify para mejorar tu contenido."
+title: "Analíticas"
+description: "Consulta el tráfico, tendencias de búsqueda, uso del asistente y comentarios de los usuarios en el panel de analíticas de Mintlify para mejorar tu contenido."
keywords: ["analytics","metrics","page views","traffic","trends","insights","impressions","CTA","call-to-action"]
boost: 3
---
@@ -25,12 +25,7 @@ Revisa tus analíticas de tráfico para:
- **Identificar páginas populares**: Utiliza las páginas mejor clasificadas para comprender qué contenido es más importante para tus usuarios y así asegurarte de que esté actualizado y sea completo.
- **Rastrear fuentes de referencia**: Comprende de dónde provienen tus usuarios para ayudarte a optimizar tu contenido para la audiencia adecuada.
-La sección **Traffic** incluye una tarjeta **Rankings**. Usa su selector de métricas para comparar **Human views**, **Agent views**, **Referrals** y **Agent visitors**.
-
-- **Encontrar las páginas más utilizadas por los agentes**: selecciona **Agent views** en **Rankings** para identificar las páginas a las que acceden con frecuencia las herramientas de IA.
-- **Identificar los agentes activos**: selecciona **Agent visitors** en **Rankings** para ver qué agentes acceden a tu documentación con más frecuencia.
-
-Mintlify identifica a los visitantes agentes por dirección IP y user agent. El recuento de visitantes agentes aproxima las fuentes distintas de tráfico de IA en lugar de sesiones o conversaciones individuales de agentes. Múltiples solicitudes desde la misma dirección IP cuentan como un solo visitante.
+La tarjeta **Rankings** de la sección **Traffic** compara **Human views**, **Agent views**, **Referrals** y **Agent visitors**. Selecciona una métrica para clasificar páginas por vistas humanas o de agentes, revisar fuentes de referencia o identificar qué agentes acceden con más frecuencia a tu documentación.
![]()
+
+ ### Vistas de agentes
+
+
+Mintlify identifica a los visitantes agentes por dirección IP y user agent. El recuento de visitantes agentes aproxima las fuentes distintas de tráfico de IA en lugar de sesiones o conversaciones individuales de agentes. Múltiples solicitudes desde la misma dirección IP cuentan como un solo visitante.
+
+Utiliza las vistas de agentes para ayudar a determinar:
+
+- **Distribución de agentes de IA**: Observa qué plataformas de IA acceden a tus documentos para saber qué herramientas prefieren tus usuarios.
+- **Oportunidades de integración**: Identifica qué plataformas de IA priorizar para optimización y pruebas.
+- **Patrones de tráfico de IA**: Supervisa qué agentes son más activos y cómo cambia su uso a lo largo del tiempo.
+
## Asistente
diff --git a/fr/optimize/analytics.mdx b/fr/optimize/analytics.mdx
index e4a750a6f3..e08a8813cf 100644
--- a/fr/optimize/analytics.mdx
+++ b/fr/optimize/analytics.mdx
@@ -1,6 +1,6 @@
---
-title: "Analytique du trafic, des agents et des recherches"
-description: "Suivez le trafic, l’usage des agents, les tendances de recherche, l’utilisation de l’assistant et les retours dans le tableau de bord Mintlify."
+title: "Analytique"
+description: "Suivez le trafic, les tendances de recherche, l'utilisation de l'assistant et les retours des utilisateurs dans le tableau de bord d'analytique Mintlify."
keywords: ["analytics","metrics","page views","traffic","trends","insights","impressions","CTA","call-to-action"]
boost: 3
---
@@ -25,12 +25,7 @@ Examinez vos analyses de trafic pour :
- **Identifier les pages populaires** : utilisez les pages les mieux classées pour comprendre quels contenus sont les plus importants pour vos utilisateurs afin de vous assurer qu'ils restent à jour et complets.
- **Suivre les sources de référence** : comprenez d'où viennent vos utilisateurs pour vous aider à optimiser votre contenu pour la bonne audience.
-La section **Traffic** comprend une carte **Rankings**. Utilisez son sélecteur de métrique pour comparer **Human views**, **Agent views**, **Referrals** et **Agent visitors**.
-
-- **Trouver les pages les plus utilisées par les agents** : sélectionnez **Agent views** dans **Rankings** pour identifier les contenus auxquels les outils IA accèdent fréquemment.
-- **Identifier les agents actifs** : sélectionnez **Agent visitors** dans **Rankings** pour voir quels agents accèdent le plus souvent à votre documentation.
-
-Mintlify identifie les visiteurs agents par adresse IP et user agent. Le nombre de visiteurs agents estime les sources distinctes de trafic IA plutôt que les sessions ou conversations individuelles d'agents. Plusieurs requêtes provenant de la même adresse IP comptent comme un seul visiteur.
+La carte **Rankings** de la section **Traffic** compare **Human views**, **Agent views**, **Referrals** et **Agent visitors**. Sélectionnez un indicateur pour classer les pages selon les vues humaines ou d'agents, consulter les sources de référence ou identifier les agents qui accèdent le plus souvent à votre documentation.
![]()
+
+ ### Vues des agents
+
+
+Mintlify identifie les visiteurs agents par adresse IP et user agent. Le nombre de visiteurs agents estime les sources distinctes de trafic IA plutôt que les sessions ou conversations individuelles d'agents. Plusieurs requêtes provenant de la même adresse IP comptent comme un seul visiteur.
+
+Utilisez les vues des agents pour vous aider à déterminer :
+
+- **Répartition des agents IA** : voyez quelles plateformes d'IA accèdent à votre documentation pour découvrir quels outils vos utilisateurs préfèrent.
+- **Opportunités d'intégration** : identifiez les plateformes d'IA à prioriser pour l'optimisation et les tests.
+- **Modèles de trafic IA** : surveillez quels agents sont les plus actifs et comment leur utilisation évolue au fil du temps.
+
## Assistant
diff --git a/optimize/analytics.mdx b/optimize/analytics.mdx
index 7b9da3d38f..34d38fb8f1 100644
--- a/optimize/analytics.mdx
+++ b/optimize/analytics.mdx
@@ -1,6 +1,6 @@
---
-title: "Analytics for traffic, AI agents, search, and feedback"
-description: "Track traffic, AI agent usage, search trends, assistant activity, and user feedback in the Mintlify analytics dashboard to improve documentation."
+title: "Analytics"
+description: "Track traffic, search trends, assistant usage, and user feedback in the Mintlify analytics dashboard to improve content and report on effectiveness."
keywords: ["analytics","metrics","page views","traffic","trends","insights","impressions","CTA","call-to-action"]
boost: 3
---
@@ -23,12 +23,7 @@ Review your traffic analytics to:
- **Identify popular pages**: Use highly ranked pages to understand what content is most important to your users. Keep those pages up to date and comprehensive.
- **Track referral sources**: Understand where your users are coming from to help you optimize your content for the right audience.
-The **Traffic** section includes a **Rankings** card. Use its metric selector to compare **Human views**, **Agent views**, **Referrals**, and **Agent visitors**.
-
-- **Find pages agents use most**: Select **Agent views** in **Rankings** to identify the pages that AI tools access frequently.
-- **Identify active agents**: Select **Agent visitors** in **Rankings** to see which agents access your documentation most often.
-
-Mintlify identifies agent visitors by IP address and user agent. The agent visitor count approximates distinct sources of AI traffic rather than individual agent sessions or conversations. Multiple requests from the same IP address count as one visitor.
+The **Rankings** card in the Traffic section compares **Human views**, **Agent views**, **Referrals**, and **Agent visitors**. Select a metric to rank pages by human or agent views, review referral sources, or identify which agents access your documentation most often.
![]()
+### Agent views
+
+Mintlify identifies agent visitors by IP address and user agent. The agent visitor count approximates distinct sources of AI traffic rather than individual agent sessions or conversations. Multiple requests from the same IP address count as one visitor.
+
+Use agent views to help determine:
+
+- **AI agent distribution**: See which AI platforms access your docs to learn which tools your users prefer.
+- **Integration opportunities**: Identify which AI platforms to prioritize for optimization and testing.
+- **AI traffic patterns**: Monitor which agents are most active and how their usage changes over time.
+
## Assistant
The assistant section of the analytics page displays assistant usage over time and chat history.
diff --git a/zh/editor/settings.mdx b/zh/editor/settings.mdx
index 9dafedfaf2..bb43aa1d61 100644
--- a/zh/editor/settings.mdx
+++ b/zh/editor/settings.mdx
@@ -1,6 +1,6 @@
---
title: "编辑器外观、AI 与发布设置"
-description: "在 Mintlify Web 编辑器中配置外观偏好、AI 指令、pull request 默认值和合并方式,管理编辑体验、编辑器行为、提交变更以及发布流程,并了解如何安全处理未发布的修改、调整编辑器布局和查看实时预览,并掌握外观、聊天、发布和危险区域设置的作用。"
+description: "在 Mintlify Web 编辑器中配置外观偏好、AI 指令、pull request 默认值和合并方式。"
keywords: ["编辑器", "设置", "ai", "指令", "发布", "pull request", "合并", "锁定分支"]
---
diff --git a/zh/optimize/analytics.mdx b/zh/optimize/analytics.mdx
index 548e9a8486..79348e4c95 100644
--- a/zh/optimize/analytics.mdx
+++ b/zh/optimize/analytics.mdx
@@ -1,6 +1,6 @@
---
-title: "流量、智能体和搜索分析"
-description: "在 Mintlify 分析仪表板中跟踪流量、AI 智能体访问、搜索趋势、助手使用情况和用户反馈,以改进文档内容、发现热门页面并评估效果。使用 Traffic 的 Rankings 指标比较 Human views、Agent views、Referrals 和 Agent visitors。"
+title: "分析"
+description: "在 Mintlify 分析仪表板中跟踪流量、搜索趋势、助手使用情况和用户反馈,以改进内容并评估效果。"
keywords: ["analytics","metrics","page views","traffic","trends","insights","impressions","CTA","call-to-action"]
boost: 3
---
@@ -25,12 +25,7 @@ boost: 3
- **识别热门页面**:通过排名靠前的页面了解哪些内容对用户最重要,从而确保这些内容保持最新且完整全面。
- **跟踪引荐来源**:了解用户来自何处,帮助您针对合适的受众优化内容。
-**Traffic** 部分包含 **Rankings** 卡片。使用其中的指标选择器比较 **Human views**、**Agent views**、**Referrals** 和 **Agent visitors**。
-
-- **查找智能体最常使用的页面**:在 **Rankings** 中选择 **Agent views**,找出 AI 工具经常访问的页面。
-- **识别活跃的智能体**:在 **Rankings** 中选择 **Agent visitors**,查看最常访问您文档的智能体。
-
-Mintlify 通过 IP 地址和用户代理来识别智能体访客。智能体访客计数近似地反映了不同的 AI 流量来源,而非单个智能体会话或对话。来自同一 IP 地址的多次请求计为一位访客。
+**Traffic** 部分的 **Rankings** 卡片可比较 **Human views**、**Agent views**、**Referrals** 和 **Agent visitors**。选择指标可按人类或智能体浏览量对页面进行排名、查看引荐来源,或识别最常访问文档的智能体。
![]()
+
+ ### 智能体浏览量
+
+
+Mintlify 通过 IP 地址和用户代理来识别智能体访客。智能体访客计数近似地反映了不同的 AI 流量来源,而非单个智能体会话或对话。来自同一 IP 地址的多次请求计为一位访客。
+
+使用智能体浏览量可以帮助确定:
+
+- **AI 智能体分布**:查看哪些 AI 平台访问了您的文档,了解用户偏好使用哪些工具。
+- **集成机会**:确定优先针对哪些 AI 平台进行优化和测试。
+- **AI 流量模式**:监控哪些智能体最活跃,以及它们的使用情况如何随时间变化。
+
## 助手