+ ## Flujo de trabajo de la POC
+
+
+Completa estos pasos en orden:
+
+| Paso | Resultado |
+|---|---|
+| 1. Conecta tu repositorio | Despliega un sitio inicial. |
+| 2. Invita a tu equipo | Da a los participantes el acceso que necesitan. |
+| 3. Agrega contenido de muestra | Prueba páginas representativas y complejas. |
+| 4. Publica un cambio | Verifica tu flujo de trabajo de redacción y revisión. |
+| 5. Aplica tu marca | Alinea el sitio con tu producto. |
+| 6. Prueba las funciones de IA | Evalúa las respuestas del asistente y un flujo de trabajo de IA. |
+| 7. Revisa los requisitos de TI y seguridad | Confirma los requisitos de autenticación y cumplimiento. |
+| 8. Revisa los resultados | Compara la POC con tus criterios de éxito. |
+
+Tu repositorio sigue siendo la fuente de la verdad. El dashboard te permite editar, configurar y publicar los archivos `.mdx` y la configuración `docs.json` de ese repositorio. Tu sitio en vivo muestra el resultado publicado.
+
+
+ ## Antes de comenzar
+
+
+
+ ### Identifica a los participantes
+
+
+| Rol | Responsabilidad | Tiempo necesario |
+|---|---|---|
+| Responsable de la documentación | Dirige la POC y completa la mayoría de los pasos. | Unas pocas horas en total |
+| Administrador de GitHub | Aprueba la aplicación de GitHub de Mintlify. | 15 minutos |
+| Diseñador o responsable de marca | Proporciona logotipos, colores y fuentes. | 30 minutos |
+| Administrador de identidad o TI | Configura la autenticación y el DNS, si es necesario. | 1 a 2 horas |
+| Responsable de la decisión | Revisa la POC frente a tus criterios de éxito. | 1 hora |
+
+
+ ### Reúne tu contenido y tus recursos de marca
+
+
+Recopila:
+
+- Variantes clara y oscura del logotipo en formato SVG o PNG.
+- Un favicon, preferiblemente en formato SVG.
+- Los colores de tu marca como valores hexadecimales.
+- Los archivos de fuentes o los nombres de tus Google Fonts.
+- Un enlace a tu documentación actual o una exportación del contenido.
+- Tu archivo o URL de OpenAPI, si documentas una API.
+- Tus 20 a 30 páginas con más tráfico.
+
+
+ ### Define el éxito
+
+
+Elige un objetivo de negocio y registra su línea base actual:
+
+- **Adquisición:** Mejorar la tasa de activación o el tiempo hasta la primera integración.
+- **Desvío:** Reducir el volumen de tickets de un tema de soporte frecuente.
+- **Retención:** Aumentar la adopción de una funcionalidad después del lanzamiento.
+
+Agrega dos o tres criterios que puedas probar durante la POC. Por ejemplo:
+
+- Un redactor sin experiencia en Git puede publicar un cambio sin ayuda.
+- Tu página de referencia de API más compleja se renderiza correctamente.
+- El asistente responde 8 de 10 preguntas de soporte frecuentes y cita las páginas correctas.
+- Tu proveedor de identidad admite el inicio de sesión en el dashboard.
+
+Comparte el objetivo, la línea base y los criterios con tu representante de Mintlify.
+
+
+ ## Paso 1: Conecta tu repositorio
+
+
+
+ ## Paso 2: Invita a tu equipo
+
+
+Abre la página [Members](https://app.mintlify.com/settings/organization/members) y asigna a cada participante el rol más restringido que necesite:
+
+- **Admin:** Gestiona la configuración de la organización, la facturación y las integraciones.
+- **Editor:** Crea y publica contenido.
+- **Viewer:** Revisa el dashboard y las analíticas sin editar.
+
+Consulta [Roles](/es/dashboard/roles) para ver la lista completa de permisos.
+
+Invita al menos a un redactor que no use Git, a un ingeniero y al responsable de la decisión. Usa sus correos electrónicos de trabajo para que sus cuentas puedan conectarse a tu proveedor de identidad durante el paso 7.
+
+
+ ## Paso 3: Agrega contenido de muestra
+
+
+
+ ### Elige páginas representativas
+
+
+Comienza con tus 20 a 30 páginas con más tráfico. Incluye:
+
+- Tu página de referencia de API más compleja.
+- Una página con una tabla grande o una lista con anidamiento profundo.
+- Una página con imágenes, video o diagramas.
+- Una página con componentes personalizados o widgets incrustados.
+- Dos o tres guías típicas.
+
+Mantén la muestra por debajo de 50 páginas para poder concentrarte en la calidad de la migración.
+
+
+ ### Mueve el contenido
+
+
+
+ ### Revisa la migración
+
+
+Compara cada página de muestra con su fuente. Verifica:
+
+- Imágenes, tablas y ejemplos de código.
+- Enlaces internos y externos.
+- Componentes personalizados y contenido incrustado.
+- Las etiquetas de navegación y la ubicación de las páginas.
+
+Confirma que un usuario nuevo puede llegar a una página útil en dos clics y que las etiquetas de navegación usan términos que los lectores probablemente buscarán. Envía los problemas de migración a tu representante de Mintlify en una sola lista con la URL de la página y el resultado esperado.
+
+
+ ## Paso 4: Publica un cambio
+
+
+Pide a un redactor que no use Git que complete este paso.
+
+
+ ## Paso 5: Aplica tu marca
+
+
+Actualiza la configuración de tu marca en `docs.json`:
+
+```json docs.json
+{
+ "theme": "luma",
+ "colors": {
+ "primary": "#16A34A",
+ "light": "#07C983",
+ "dark": "#15803D"
+ },
+ "logo": {
+ "light": "/logo/light-logo.svg",
+ "dark": "/logo/dark-logo.svg"
+ },
+ "favicon": "/favicon.svg"
+}
+```
+
+Después:
+
+1. Verifica que los enlaces y botones sigan siendo legibles en modo claro y oscuro.
+2. Agrega tus fuentes usando la [configuración de fuentes](/es/customize/fonts).
+3. Agrega una imagen de Open Graph predeterminada y prueba un enlace compartido en Slack.
+
+Consulta [Ajustes de apariencia](/es/organize/settings-appearance), [Temas](/es/customize/themes) y [SEO](/es/optimize/seo) para ver otras opciones. Si no quieres editar `docs.json`, envía tus recursos a tu representante de Mintlify.
+
+
+ ## Paso 6: Prueba las funciones de IA
+
+
+
+ ### Configura el asistente
+
+
+Abre la página del [Asistente](https://app.mintlify.com/products/assistant):
+
+1. Activa el asistente.
+2. Agrega [correos de desvío](/es/assistant/configure#set-deflection-emails) para las preguntas que necesiten ayuda humana.
+3. Agrega hasta tres [preguntas iniciales](/es/assistant/configure#add-sample-questions).
+4. Agrega [dominios de búsqueda](/es/assistant/configure#search-domains) si el contenido relevante abarca varios sitios.
+5. Deja habilitada la [protección contra bots](/es/assistant/configure#bot-protection).
+
+Consulta [Personalizar el asistente](/es/assistant/customize) y [Habilidades del asistente](/es/assistant/skills) para instrucciones y tono específicos de tu producto.
+
+
+ ### Prueba preguntas reales
+
+
+1. Recopila 20 a 30 preguntas recientes de tickets de soporte o canales de la comunidad.
+2. Haz cada pregunta a través de **Ask Assistant** en tu sitio.
+3. Registra si la respuesta es correcta y cita la página adecuada.
+4. Usa las respuestas erróneas o faltantes para identificar páginas que actualizar o crear.
+
+Revisa las preguntas sin respuesta y con voto negativo en las [analíticas del asistente](/es/analytics/assistant). Si una página relevante no se cita, haz que la `description` de su frontmatter sea específica y única.
+
+
+ ### Prueba un flujo de trabajo de IA adicional
+
+
+Elige el flujo de trabajo más relevante para tu evaluación:
+
+
+ ## Paso 7: Revisa los requisitos de TI y seguridad
+
+
+Involucra a tu equipo de TI o seguridad en la POC antes de la revisión final.
+
+
+ ### Controla el acceso al dashboard
+
+
+Evalúa los controles que tu equipo requiere:
+
+- [Inicio de sesión único](/es/dashboard/sso) con SAML u OIDC.
+- [Aprovisionamiento de SCIM](/es/dashboard/scim).
+- [Políticas de acceso a la red](/es/dashboard/network-access).
+- [Registros de auditoría](/es/dashboard/audit-logs) y [seguridad de sesiones](/es/dashboard/session-security).
+
+
+ ### Controla el acceso a la documentación
+
+
+Configura la [autenticación](/es/deploy/authentication-setup) para tus lectores:
+
+- **Contraseña:** Control de acceso rápido para una POC.
+- **Acceso administrado por Mintlify:** Usa tu organización del dashboard como lista de usuarios.
+- **OAuth 2.0:** Se conecta a tu proveedor de identidad.
+- **JWT:** Admite modelos de acceso programático personalizados.
+
+Usa [grupos](/es/deploy/authentication-setup#control-access-with-groups) para restringir páginas específicas:
+
+```yaml
+---
+title: "Production runbook"
+groups: ["engineering"]
+---
+```
+
+Haz la prueba con una cuenta dentro del grupo y otra cuenta fuera de él.
+
+
+ ### Completa las verificaciones de infraestructura y cumplimiento
+
+
+- Agrega un [dominio personalizado](/es/customize/custom-domain). Usa un subdominio de prueba durante la POC.
+- Conecta tu [plataforma de analíticas](/es/integrations/analytics/overview).
+- Habilita las [comprobaciones de CI](/es/deploy/ci) para enlaces y accesibilidad.
+- Comparte [Contratación empresarial](/es/enterprise-contracting) con los equipos de seguridad y compras.
+
+
+ ## Paso 8: Revisa los resultados
+
+
+Reserva una hora con tu responsable de la decisión. Comienza con el objetivo y la línea base que definiste antes de la POC y luego revisa:
+
+| Criterio | Evidencia |
+|---|---|
+| Una persona sin perfil de desarrollo puede publicar | El resultado del paso 4 y el tiempo requerido. |
+| Los ingenieros conservan el control de revisión | El pull request y sus comprobaciones. |
+| El contenido complejo se migra correctamente | Páginas de muestra comparadas lado a lado. |
+| El asistente responde con precisión | Tus preguntas puntuadas y las páginas citadas. |
+| Las brechas de contenido son identificables | Preguntas sin respuesta y con voto negativo en las [analíticas del asistente](/es/analytics/assistant). |
+| Los lectores encuentran contenido útil | Datos de [tráfico](/es/analytics/traffic), [búsqueda](/es/analytics/search) e [interacción](/es/analytics/user-engagements). |
+| Las actualizaciones automatizadas son útiles | El historial de ejecuciones de la automatización y el cambio propuesto. |
+| Se cumplen los requisitos de seguridad | La revisión de tu equipo de TI. |
+
+Resuelve las preguntas pendientes con tu representante de Mintlify antes de esta reunión.
+
+
+ ## Cronograma sugerido
+
+
+La mayoría de las POC toman dos a tres semanas:
+
+| Semana | Enfoque |
+|---|---|
+| Semana 1 | Conecta el repositorio, invita a tu equipo, define el éxito y comienza la migración del contenido. Inicia la configuración del dominio si necesitas autenticación. |
+| Semana 2 | Revisa el contenido, publica un cambio, aplica tu marca, prueba el asistente y evalúa un flujo de trabajo de IA. |
+| Semana 3 | Completa la revisión de TI y seguridad y luego revisa los resultados con tu responsable de la decisión. |
+
+
+ ## Obtener ayuda
+
+
+- Usa tu canal compartido de Slack para preguntas urgentes sobre la POC.
+- Escribe a [support@mintlify.com](mailto:support@mintlify.com) para otras preguntas.
+- Consulta [Soporte avanzado](/es/advanced-support) para ver las opciones de soporte posteriores a la POC.
+
+
+ ## Después de la POC
+
+
+
+ ## Workflow du POC
+
+
+Effectuez ces étapes dans l'ordre :
+
+| Étape | Résultat |
+|---|---|
+| 1. Connecter votre dépôt | Déployer un site de démarrage. |
+| 2. Inviter votre équipe | Donner aux participants l'accès dont ils ont besoin. |
+| 3. Ajouter du contenu d'exemple | Tester des pages représentatives et complexes. |
+| 4. Publier une modification | Vérifier votre workflow de rédaction et de revue. |
+| 5. Appliquer votre image de marque | Aligner le site sur votre produit. |
+| 6. Tester les fonctionnalités d'IA | Évaluer les réponses de l'assistant et un workflow d'IA. |
+| 7. Passer en revue les exigences IT et de sécurité | Confirmer les exigences d'authentification et de conformité. |
+| 8. Passer en revue les résultats | Comparer le POC à vos critères de réussite. |
+
+Votre dépôt reste la source de vérité. Le tableau de bord vous permet de modifier, configurer et publier les fichiers `.mdx` et la configuration `docs.json` de ce dépôt. Votre site en ligne affiche le résultat publié.
+
+
+ ## Avant de commencer
+
+
+
+ ### Identifier les participants
+
+
+| Rôle | Responsabilité | Temps nécessaire |
+|---|---|---|
+| Responsable de la documentation | Pilote le POC et réalise la plupart des étapes. | Quelques heures au total |
+| Administrateur GitHub | Approuve la GitHub App Mintlify. | 15 minutes |
+| Designer ou responsable de la marque | Fournit les logos, les couleurs et les polices. | 30 minutes |
+| Administrateur des identités ou IT | Configure l'authentification et le DNS, si nécessaire. | 1 à 2 heures |
+| Décideur | Évalue le POC par rapport à vos critères de réussite. | 1 heure |
+
+
+ ### Rassembler votre contenu et vos éléments de marque
+
+
+Rassemblez :
+
+- Les variantes claire et sombre de votre logo au format SVG ou PNG.
+- Un favicon, de préférence au format SVG.
+- Les couleurs de votre marque sous forme de valeurs hexadécimales.
+- Les fichiers de polices ou les noms de vos Google Fonts.
+- Un lien vers votre documentation actuelle ou un export du contenu.
+- Votre fichier ou URL OpenAPI, si vous documentez une API.
+- Vos 20 à 30 pages les plus consultées.
+
+
+ ### Définir la réussite
+
+
+Choisissez un objectif métier et notez sa valeur de référence actuelle :
+
+- **Acquisition :** améliorer le taux d'activation ou le délai jusqu'à la première intégration.
+- **Déviation :** réduire le volume de tickets pour un sujet de support courant.
+- **Rétention :** augmenter l'adoption d'une fonctionnalité après son lancement.
+
+Ajoutez deux ou trois critères que vous pouvez tester pendant le POC. Par exemple :
+
+- Un rédacteur sans expérience de Git peut publier une modification sans aide.
+- Votre page de référence d'API la plus complexe s'affiche correctement.
+- L'assistant répond à 8 questions de support courantes sur 10 et cite les bonnes pages.
+- Votre fournisseur d'identité prend en charge la connexion au tableau de bord.
+
+Partagez l'objectif, la valeur de référence et les critères avec votre représentant Mintlify.
+
+
+ ## Étape 1 : connecter votre dépôt
+
+
+
+ ## Étape 2 : inviter votre équipe
+
+
+Ouvrez la page [Membres](https://app.mintlify.com/settings/organization/members) et attribuez à chaque participant le rôle le plus restreint dont il a besoin :
+
+- **Admin :** gère les paramètres de l'organisation, la facturation et les intégrations.
+- **Editor :** crée et publie du contenu.
+- **Viewer :** consulte le tableau de bord et les analyses sans pouvoir modifier.
+
+Consultez [Rôles](/fr/dashboard/roles) pour la liste complète des autorisations.
+
+Invitez au moins un rédacteur qui n'utilise pas Git, un ingénieur et le décideur. Utilisez leurs adresses e-mail professionnelles afin que leurs comptes puissent se connecter à votre fournisseur d'identité lors de l'étape 7.
+
+
+ ## Étape 3 : ajouter du contenu d'exemple
+
+
+
+ ### Choisir des pages représentatives
+
+
+Commencez par vos 20 à 30 pages les plus consultées. Incluez :
+
+- Votre page de référence d'API la plus complexe.
+- Une page contenant un grand tableau ou une liste profondément imbriquée.
+- Une page contenant des images, des vidéos ou des diagrammes.
+- Une page contenant des composants personnalisés ou des widgets intégrés.
+- Deux ou trois guides typiques.
+
+Limitez l'échantillon à moins de 50 pages pour pouvoir vous concentrer sur la qualité de la migration.
+
+
+ ### Déplacer le contenu
+
+
+
+ ### Vérifier la migration
+
+
+Comparez chaque page d'exemple avec sa source. Vérifiez :
+
+- Les images, les tableaux et les exemples de code.
+- Les liens internes et externes.
+- Les composants personnalisés et les contenus intégrés.
+- Les libellés de navigation et l'emplacement des pages.
+
+Confirmez qu'un nouvel utilisateur peut atteindre une page utile en deux clics et que les libellés de navigation utilisent des termes que les lecteurs sont susceptibles de rechercher. Envoyez les problèmes de migration à votre représentant Mintlify dans une seule liste, avec l'URL de la page et le résultat attendu.
+
+
+ ## Étape 4 : publier une modification
+
+
+Demandez à un rédacteur qui n'utilise pas Git de réaliser cette étape.
+
+
+ ## Étape 5 : appliquer votre image de marque
+
+
+Mettez à jour les paramètres de votre marque dans `docs.json` :
+
+```json docs.json
+{
+ "theme": "luma",
+ "colors": {
+ "primary": "#16A34A",
+ "light": "#07C983",
+ "dark": "#15803D"
+ },
+ "logo": {
+ "light": "/logo/light-logo.svg",
+ "dark": "/logo/dark-logo.svg"
+ },
+ "favicon": "/favicon.svg"
+}
+```
+
+Ensuite :
+
+1. Vérifiez que les liens et les boutons restent lisibles en mode clair et en mode sombre.
+2. Ajoutez vos polices via les [paramètres de police](/fr/customize/fonts).
+3. Ajoutez une image Open Graph par défaut et testez un lien partagé dans Slack.
+
+Consultez les [paramètres d'apparence](/fr/organize/settings-appearance), les [thèmes](/fr/customize/themes) et le [SEO](/fr/optimize/seo) pour les autres options. Si vous ne souhaitez pas modifier `docs.json`, envoyez vos éléments de marque à votre représentant Mintlify.
+
+
+ ## Étape 6 : tester les fonctionnalités d'IA
+
+
+
+ ### Configurer l'assistant
+
+
+Ouvrez la page [Assistant](https://app.mintlify.com/products/assistant) :
+
+1. Activez l'assistant.
+2. Ajoutez des [e-mails de redirection](/fr/assistant/configure#set-deflection-emails) pour les questions nécessitant une aide humaine.
+3. Ajoutez jusqu'à trois [questions de démarrage](/fr/assistant/configure#add-sample-questions).
+4. Ajoutez des [domaines de recherche](/fr/assistant/configure#search-domains) si du contenu pertinent est réparti sur plusieurs sites.
+5. Laissez la [protection contre les bots](/fr/assistant/configure#bot-protection) activée.
+
+Consultez [Personnaliser l'assistant](/fr/assistant/customize) et [Compétences de l'assistant](/fr/assistant/skills) pour des instructions spécifiques au produit et le ton des réponses.
+
+
+ ### Tester des questions réelles
+
+
+1. Rassemblez 20 à 30 questions récentes issues des tickets de support ou des canaux communautaires.
+2. Posez chaque question via **Ask Assistant** sur votre site.
+3. Notez si la réponse est correcte et si elle cite la bonne page.
+4. Utilisez les réponses erronées ou manquantes pour identifier les pages à mettre à jour ou à créer.
+
+Passez en revue les questions sans réponse et celles ayant reçu un vote négatif dans les [analyses de l'assistant](/fr/analytics/assistant). Si une page pertinente n'est pas citée, rendez sa `description` de frontmatter spécifique et unique.
+
+
+ ### Tester un workflow d'IA supplémentaire
+
+
+Choisissez le workflow le plus pertinent pour votre évaluation :
+
+
+ ## Étape 7 : passer en revue les exigences IT et de sécurité
+
+
+Impliquez votre équipe IT ou sécurité dans le POC avant la revue finale.
+
+
+ ### Contrôler l'accès au tableau de bord
+
+
+Évaluez les contrôles requis par votre équipe :
+
+- L'[authentification unique](/fr/dashboard/sso) avec SAML ou OIDC.
+- Le [provisionnement SCIM](/fr/dashboard/scim).
+- Les [politiques d'accès réseau](/fr/dashboard/network-access).
+- Les [journaux d'audit](/fr/dashboard/audit-logs) et la [sécurité des sessions](/fr/dashboard/session-security).
+
+
+ ### Contrôler l'accès à la documentation
+
+
+Configurez l'[authentification](/fr/deploy/authentication-setup) pour vos lecteurs :
+
+- **Mot de passe :** contrôle d'accès rapide pour un POC.
+- **Accès géré par Mintlify :** utilise l'organisation de votre tableau de bord comme liste d'utilisateurs.
+- **OAuth 2.0 :** se connecte à votre fournisseur d'identité.
+- **JWT :** prend en charge des modèles d'accès programmatiques personnalisés.
+
+Utilisez les [groupes](/fr/deploy/authentication-setup#control-access-with-groups) pour restreindre certaines pages :
+
+```yaml
+---
+title: "Production runbook"
+groups: ["engineering"]
+---
+```
+
+Testez avec un compte appartenant au groupe et un compte en dehors du groupe.
+
+
+ ### Effectuer les vérifications d'infrastructure et de conformité
+
+
+- Ajoutez un [domaine personnalisé](/fr/customize/custom-domain). Utilisez un sous-domaine de test pendant le POC.
+- Connectez votre [plateforme d'analyse](/fr/integrations/analytics/overview).
+- Activez les [vérifications CI](/fr/deploy/ci) pour les liens et l'accessibilité.
+- Partagez [Contrats entreprise](/fr/enterprise-contracting) avec les équipes sécurité et achats.
+
+
+ ## Étape 8 : passer en revue les résultats
+
+
+Réservez une heure avec votre décideur. Commencez par l'objectif et la valeur de référence définis avant le POC, puis passez en revue :
+
+| Critère | Preuve |
+|---|---|
+| Un non-développeur peut publier | Le résultat de l'étape 4 et le temps nécessaire. |
+| Les ingénieurs gardent le contrôle des revues | La pull request et ses vérifications. |
+| Le contenu complexe migre correctement | Les pages d'exemple comparées côte à côte. |
+| L'assistant répond avec précision | Vos questions notées et les pages citées. |
+| Les lacunes de contenu sont identifiables | Les questions sans réponse et avec vote négatif dans les [analyses de l'assistant](/fr/analytics/assistant). |
+| Les lecteurs trouvent du contenu utile | Les données de [trafic](/fr/analytics/traffic), de [recherche](/fr/analytics/search) et d'[engagement](/fr/analytics/user-engagements). |
+| Les mises à jour automatisées sont utiles | L'historique des exécutions de l'automatisation et la modification proposée. |
+| Les exigences de sécurité sont satisfaites | La revue de votre équipe IT. |
+
+Résolvez les questions en suspens avec votre représentant Mintlify avant cette réunion.
+
+
+ ## Calendrier suggéré
+
+
+La plupart des POC durent deux à trois semaines :
+
+| Semaine | Priorité |
+|---|---|
+| Semaine 1 | Connecter le dépôt, inviter votre équipe, définir la réussite et démarrer la migration du contenu. Commencer la configuration du domaine si vous avez besoin de l'authentification. |
+| Semaine 2 | Vérifier le contenu, publier une modification, appliquer l'image de marque, tester l'assistant et évaluer un workflow d'IA. |
+| Semaine 3 | Terminer la revue IT et sécurité, puis passer en revue les résultats avec votre décideur. |
+
+
+ ## Obtenir de l'aide
+
+
+- Utilisez votre canal Slack partagé pour les questions urgentes liées au POC.
+- Écrivez à [support@mintlify.com](mailto:support@mintlify.com) pour les autres questions.
+- Consultez [Support avancé](/fr/advanced-support) pour les options de support après le POC.
+
+
+ ## Après le POC
+
+
+
+ ## POC 工作流
+
+
+请按顺序完成以下步骤：
+
+| 步骤 | 成果 |
+|---|---|
+| 1. 连接你的仓库 | 部署一个入门站点。 |
+| 2. 邀请你的团队 | 为参与者提供所需的访问权限。 |
+| 3. 添加示例内容 | 测试具有代表性的复杂页面。 |
+| 4. 发布一次更改 | 验证你的写作和审查工作流。 |
+| 5. 应用品牌样式 | 让站点与你的产品保持一致。 |
+| 6. 测试 AI 功能 | 评估助手的回答和一个 AI 工作流。 |
+| 7. 审查 IT 和安全要求 | 确认身份验证和合规要求。 |
+| 8. 审查结果 | 将 POC 与你的成功标准进行对比。 |
+
+你的仓库始终是唯一数据源。控制面板让你可以编辑、配置和发布该仓库中的 `.mdx` 文件和 `docs.json` 配置。你的线上站点展示发布后的结果。
+
+
+ ## 开始之前
+
+
+
+ ### 确定参与者
+
+
+| 角色 | 职责 | 所需时间 |
+|---|---|---|
+| 文档负责人 | 主导 POC 并完成大部分步骤。 | 总计几个小时 |
+| GitHub 管理员 | 批准 Mintlify GitHub 应用。 | 15 分钟 |
+| 设计师或品牌负责人 | 提供徽标、颜色和字体。 | 30 分钟 |
+| 身份或 IT 管理员 | 配置身份验证和 DNS（如需要）。 | 1 到 2 小时 |
+| 决策者 | 根据你的成功标准审查 POC。 | 1 小时 |
+
+
+ ### 收集你的内容和品牌资产
+
+
+请收集：
+
+- SVG 或 PNG 格式的浅色和深色徽标版本。
+- 一个网站图标（favicon），最好是 SVG 格式。
+- 以十六进制值表示的品牌颜色。
+- 字体文件或你的 Google Fonts 字体名称。
+- 你当前文档的链接或内容导出文件。
+- 你的 OpenAPI 文件或 URL（如果你需要为 API 编写文档）。
+- 你流量最高的 20 到 30 个页面。
+
+
+ ### 定义成功标准
+
+
+选择一个业务目标并记录其当前基线：
+
+- **获客：** 提高激活率或缩短首次集成所需时间。
+- **工单转移：** 减少某个常见支持主题的工单数量。
+- **留存：** 提高某个功能发布后的采用率。
+
+添加两到三条可以在 POC 期间测试的标准。例如：
+
+- 一位没有 Git 经验的作者可以在无人协助的情况下发布更改。
+- 你最复杂的 API 参考页面能正确渲染。
+- 助手能正确回答 10 个常见支持问题中的 8 个，并引用正确的页面。
+- 你的身份提供商支持控制面板登录。
+
+将目标、基线和标准分享给你的 Mintlify 代表。
+
+
+ ## 第 1 步：连接你的仓库
+
+
+
+ ## 第 2 步：邀请你的团队
+
+
+打开[成员](https://app.mintlify.com/settings/organization/members)页面，为每位参与者分配其所需的最小角色：
+
+- **Admin：** 管理组织设置、账单和集成。
+- **Editor：** 创建和发布内容。
+- **Viewer：** 查看控制面板和分析数据，但不能编辑。
+
+完整的权限列表请参阅[角色](/zh/dashboard/roles)。
+
+至少邀请一位不使用 Git 的作者、一位工程师和决策者。使用他们的工作邮箱，以便在第 7 步中将他们的账号连接到你的身份提供商。
+
+
+ ## 第 3 步：添加示例内容
+
+
+
+ ### 选择有代表性的页面
+
+
+从你流量最高的 20 到 30 个页面开始。请包含：
+
+- 你最复杂的 API 参考页面。
+- 一个包含大型表格或深层嵌套列表的页面。
+- 一个包含图片、视频或图表的页面。
+- 一个包含自定义组件或嵌入式小组件的页面。
+- 两到三篇典型的指南。
+
+将示例控制在 50 页以内，以便你专注于迁移质量。
+
+
+ ### 迁移内容
+
+
+
+ ### 审查迁移结果
+
+
+将每个示例页面与其源页面进行对比。检查：
+
+- 图片、表格和代码示例。
+- 内部和外部链接。
+- 自定义组件和嵌入内容。
+- 导航标签和页面位置。
+
+确认新用户能在两次点击内到达有用的页面，并且导航标签使用读者可能搜索的术语。将迁移问题整理成一份列表（包含页面 URL 和预期结果）发送给你的 Mintlify 代表。
+
+
+ ## 第 4 步：发布一次更改
+
+
+请一位不使用 Git 的作者完成此步骤。
+
+
+ ## 第 5 步：应用品牌样式
+
+
+在 `docs.json` 中更新你的品牌设置：
+
+```json docs.json
+{
+ "theme": "luma",
+ "colors": {
+ "primary": "#16A34A",
+ "light": "#07C983",
+ "dark": "#15803D"
+ },
+ "logo": {
+ "light": "/logo/light-logo.svg",
+ "dark": "/logo/dark-logo.svg"
+ },
+ "favicon": "/favicon.svg"
+}
+```
+
+然后：
+
+1. 检查链接和按钮在浅色和深色模式下是否清晰可读。
+2. 使用[字体设置](/zh/customize/fonts)添加你的字体。
+3. 添加默认的 Open Graph 图片，并在 Slack 中测试分享链接的效果。
+
+其他选项请参阅[外观设置](/zh/organize/settings-appearance)、[主题](/zh/customize/themes)和 [SEO](/zh/optimize/seo)。如果你不想编辑 `docs.json`，请将资产发送给你的 Mintlify 代表。
+
+
+ ## 第 6 步：测试 AI 功能
+
+
+
+ ### 配置助手
+
+
+打开[助手](https://app.mintlify.com/products/assistant)页面：
+
+1. 启用助手。
+2. 为需要人工协助的问题添加[转接电子邮件](/zh/assistant/configure#set-deflection-emails)。
+3. 添加最多三个[起始问题](/zh/assistant/configure#add-sample-questions)。
+4. 如果相关内容分布在多个站点上，请添加[搜索域名](/zh/assistant/configure#search-domains)。
+5. 保持[机器人防护](/zh/assistant/configure#bot-protection)处于启用状态。
+
+有关产品专属说明和语气，请参阅[自定义助手](/zh/assistant/customize)和[助手技能](/zh/assistant/skills)。
+
+
+ ### 测试真实问题
+
+
+1. 从支持工单或社区渠道收集 20 到 30 个近期问题。
+2. 通过站点上的 **Ask Assistant** 逐个提问。
+3. 记录回答是否正确以及是否引用了正确的页面。
+4. 利用错误或缺失的回答来确定需要更新或创建的页面。
+
+在[助手分析](/zh/analytics/assistant)中审查未回答和被点踩的问题。如果相关页面未被引用，请让其 frontmatter `description` 更加具体和独特。
+
+
+ ### 测试一个额外的 AI 工作流
+
+
+选择与你的评估最相关的工作流：
+
+
+ ## 第 7 步：审查 IT 和安全要求
+
+
+在最终审查之前，让你的 IT 或安全团队参与到 POC 中。
+
+
+ ### 控制控制面板访问权限
+
+
+评估你的团队所需的控制措施：
+
+- 使用 SAML 或 OIDC 的[单点登录](/zh/dashboard/sso)。
+- [SCIM 配置](/zh/dashboard/scim)。
+- [网络访问策略](/zh/dashboard/network-access)。
+- [审计日志](/zh/dashboard/audit-logs)和[会话安全](/zh/dashboard/session-security)。
+
+
+ ### 控制文档访问权限
+
+
+为你的读者配置[身份验证](/zh/deploy/authentication-setup)：
+
+- **密码：** 适用于 POC 的快速访问控制。
+- **Mintlify 托管访问：** 使用你的控制面板组织作为用户列表。
+- **OAuth 2.0：** 连接到你的身份提供商。
+- **JWT：** 支持自定义的程序化访问模型。
+
+使用[群组](/zh/deploy/authentication-setup#control-access-with-groups)限制特定页面：
+
+```yaml
+---
+title: "Production runbook"
+groups: ["engineering"]
+---
+```
+
+分别使用一个属于该群组的账号和一个不属于该群组的账号进行测试。
+
+
+ ### 完成基础设施和合规检查
+
+
+- 添加[自定义域名](/zh/customize/custom-domain)。在 POC 期间使用测试子域名。
+- 连接你的[分析平台](/zh/integrations/analytics/overview)。
+- 为链接和可访问性启用 [CI 检查](/zh/deploy/ci)。
+- 与安全和采购团队分享[企业合同](/zh/enterprise-contracting)。
+
+
+ ## 第 8 步：审查结果
+
+
+与决策者预约一小时的会议。从 POC 前定义的目标和基线开始，然后审查：
+
+| 标准 | 证据 |
+|---|---|
+| 非开发人员可以发布内容 | 第 4 步的结果和所需时间。 |
+| 工程师保留审查控制权 | 拉取请求及其检查。 |
+| 复杂内容迁移正确 | 示例页面的并排对比。 |
+| 助手回答准确 | 你评分过的问题和引用的页面。 |
+| 可以识别内容缺口 | [助手分析](/zh/analytics/assistant)中未回答和被点踩的问题。 |
+| 读者能找到有用的内容 | [流量](/zh/analytics/traffic)、[搜索](/zh/analytics/search)和[用户参与](/zh/analytics/user-engagements)数据。 |
+| 自动更新有价值 | 自动化的运行历史和提出的更改。 |
+| 满足安全要求 | 你的 IT 团队的审查结果。 |
+
+在此会议之前，与你的 Mintlify 代表解决所有未决问题。
+
+
+ ## 建议时间表
+
+
+大多数 POC 需要两到三周：
+
+| 周 | 重点 |
+|---|---|
+| 第 1 周 | 连接仓库、邀请团队、定义成功标准并开始内容迁移。如果需要身份验证，开始域名设置。 |
+| 第 2 周 | 审查内容、发布一次更改、应用品牌样式、测试助手并评估一个 AI 工作流。 |
+| 第 3 周 | 完成 IT 和安全审查，然后与决策者一起审查结果。 |
+
+
+ ## 获取帮助
+
+
+- 对于时间紧迫的 POC 问题，请使用你的共享 Slack 频道。
+- 其他问题请发送邮件至 [support@mintlify.com](mailto:support@mintlify.com)。
+- 有关 POC 之后的支持选项，请参阅[高级支持](/zh/advanced-support)。
+
+
+ ## POC 之后
+
+
+
@@ -44,7 +44,6 @@ Tu repositorio sigue siendo la fuente de la verdad. El dashboard te permite edit
| Administrador de GitHub | Aprueba la aplicación de GitHub de Mintlify. | 15 minutos |
| Diseñador o responsable de marca | Proporciona logotipos, colores y fuentes. | 30 minutos |
| Administrador de identidad o TI | Configura la autenticación y el DNS, si es necesario. | 1 a 2 horas |
-| Responsable de la decisión | Revisa la POC frente a tus criterios de éxito. | 1 hora |
### Reúne tu contenido y tus recursos de marca
@@ -64,10 +63,11 @@ Recopila:
### Define el éxito
-Elige un objetivo de negocio y registra su línea base actual:
+Elige uno de los impulsores de valor con los que los clientes suelen evaluar Mintlify y registra su línea base actual:
- **Adquisición:** Mejorar la tasa de activación o el tiempo hasta la primera integración.
- **Desvío:** Reducir el volumen de tickets de un tema de soporte frecuente.
+- **Ahorro de tiempo de ingeniería:** Reducir las horas de ingeniería dedicadas a redactar, revisar y mantener la documentación.
- **Retención:** Aumentar la adopción de una funcionalidad después del lanzamiento.
Agrega dos o tres criterios que puedas probar durante la POC. Por ejemplo:
@@ -77,7 +77,7 @@ Agrega dos o tres criterios que puedas probar durante la POC. Por ejemplo:
- El asistente responde 8 de 10 preguntas de soporte frecuentes y cita las páginas correctas.
- Tu proveedor de identidad admite el inicio de sesión en el dashboard.
-Comparte el objetivo, la línea base y los criterios con tu representante de Mintlify.
+Comparte el objetivo, la línea base y los criterios con tu AE o SE.
## Paso 1: Conecta tu repositorio
@@ -155,7 +155,7 @@ Mantén la muestra por debajo de 50 páginas para poder concentrarte en la calid
- Pregunta a tu representante de Mintlify si la migración está incluida en tu POC. Si lo está, envía:
+ Pregunta a tu AE o SE si la migración está incluida en tu POC. Si lo está, envía:
- La URL o exportación de tu documentación actual.
- Tu lista de páginas de muestra.
@@ -191,7 +191,7 @@ Compara cada página de muestra con su fuente. Verifica:
- Componentes personalizados y contenido incrustado.
- Las etiquetas de navegación y la ubicación de las páginas.
-Confirma que un usuario nuevo puede llegar a una página útil en dos clics y que las etiquetas de navegación usan términos que los lectores probablemente buscarán. Envía los problemas de migración a tu representante de Mintlify en una sola lista con la URL de la página y el resultado esperado.
+Confirma que un usuario nuevo puede llegar a una página útil en dos clics y que las etiquetas de navegación usan términos que los lectores probablemente buscarán. Envía los problemas de migración a tu AE o SE en una sola lista con la URL de la página y el resultado esperado.
## Paso 4: Publica un cambio
@@ -263,7 +263,7 @@ Después:
2. Agrega tus fuentes usando la [configuración de fuentes](/es/customize/fonts).
3. Agrega una imagen de Open Graph predeterminada y prueba un enlace compartido en Slack.
-Consulta [Ajustes de apariencia](/es/organize/settings-appearance), [Temas](/es/customize/themes) y [SEO](/es/optimize/seo) para ver otras opciones. Si no quieres editar `docs.json`, envía tus recursos a tu representante de Mintlify.
+Consulta [Ajustes de apariencia](/es/organize/settings-appearance), [Temas](/es/customize/themes) y [SEO](/es/optimize/seo) para ver otras opciones. Si no quieres editar `docs.json`, envía tus recursos a tu AE o SE.
## Paso 6: Prueba las funciones de IA
@@ -389,7 +389,7 @@ Reserva una hora con tu responsable de la decisión. Comienza con el objetivo y
| Las actualizaciones automatizadas son útiles | El historial de ejecuciones de la automatización y el cambio propuesto. |
| Se cumplen los requisitos de seguridad | La revisión de tu equipo de TI. |
-Resuelve las preguntas pendientes con tu representante de Mintlify antes de esta reunión.
+Resuelve las preguntas pendientes con tu AE o SE antes de esta reunión.
## Cronograma sugerido
@@ -403,14 +403,6 @@ La mayoría de las POC toman dos a tres semanas:
| Semana 2 | Revisa el contenido, publica un cambio, aplica tu marca, prueba el asistente y evalúa un flujo de trabajo de IA. |
| Semana 3 | Completa la revisión de TI y seguridad y luego revisa los resultados con tu responsable de la decisión. |
-
- Si vous êtes bloqué, contactez votre représentant Mintlify dans votre canal Slack partagé ou écrivez à [support@mintlify.com](mailto:support@mintlify.com).
+ Si vous êtes bloqué, contactez votre responsable de compte (AE, account executive) ou votre ingénieur solutions (SE, solutions engineer), ou écrivez à [support@mintlify.com](mailto:support@mintlify.com).
- ## Obtener ayuda
-
-
-- Usa tu canal compartido de Slack para preguntas urgentes sobre la POC.
-- Escribe a [support@mintlify.com](mailto:support@mintlify.com) para otras preguntas.
-- Consulta [Soporte avanzado](/es/advanced-support) para ver las opciones de soporte posteriores a la POC.
-
## Después de la POC
diff --git a/fr/poc-onboarding.mdx b/fr/poc-onboarding.mdx
index f913d2f92..342c1338e 100644
--- a/fr/poc-onboarding.mdx
+++ b/fr/poc-onboarding.mdx
@@ -8,7 +8,7 @@ noindex: true
Utilisez ce guide pour mettre en place un site de documentation fonctionnel et évaluer Mintlify avec votre équipe. La plupart des tâches se déroulent dans le tableau de bord, mais vous aurez besoin d'une aide ponctuelle des administrateurs GitHub et IT pour certaines étapes.
@@ -44,7 +44,6 @@ Votre dépôt reste la source de vérité. Le tableau de bord vous permet de mod
| Administrateur GitHub | Approuve la GitHub App Mintlify. | 15 minutes |
| Designer ou responsable de la marque | Fournit les logos, les couleurs et les polices. | 30 minutes |
| Administrateur des identités ou IT | Configure l'authentification et le DNS, si nécessaire. | 1 à 2 heures |
-| Décideur | Évalue le POC par rapport à vos critères de réussite. | 1 heure |
### Rassembler votre contenu et vos éléments de marque
@@ -64,10 +63,11 @@ Rassemblez :
### Définir la réussite
-Choisissez un objectif métier et notez sa valeur de référence actuelle :
+Choisissez l'un des leviers de valeur sur lesquels les clients évaluent le plus souvent Mintlify, puis notez sa valeur de référence actuelle :
- **Acquisition :** améliorer le taux d'activation ou le délai jusqu'à la première intégration.
- **Déviation :** réduire le volume de tickets pour un sujet de support courant.
+- **Temps d'ingénierie économisé :** réduire les heures d'ingénierie consacrées à la rédaction, à la revue et à la maintenance de la documentation.
- **Rétention :** augmenter l'adoption d'une fonctionnalité après son lancement.
Ajoutez deux ou trois critères que vous pouvez tester pendant le POC. Par exemple :
@@ -77,7 +77,7 @@ Ajoutez deux ou trois critères que vous pouvez tester pendant le POC. Par exemp
- L'assistant répond à 8 questions de support courantes sur 10 et cite les bonnes pages.
- Votre fournisseur d'identité prend en charge la connexion au tableau de bord.
-Partagez l'objectif, la valeur de référence et les critères avec votre représentant Mintlify.
+Partagez l'objectif, la valeur de référence et les critères avec votre AE ou SE.
## Étape 1 : connecter votre dépôt
@@ -155,7 +155,7 @@ Limitez l'échantillon à moins de 50 pages pour pouvoir vous concentrer sur la
- Demandez à votre représentant Mintlify si la migration est incluse dans votre POC. Si c'est le cas, envoyez :
+ Demandez à votre AE ou SE si la migration est incluse dans votre POC. Si c'est le cas, envoyez :
- L'URL ou l'export de votre documentation actuelle.
- Votre liste de pages d'exemple.
@@ -191,7 +191,7 @@ Comparez chaque page d'exemple avec sa source. Vérifiez :
- Les composants personnalisés et les contenus intégrés.
- Les libellés de navigation et l'emplacement des pages.
-Confirmez qu'un nouvel utilisateur peut atteindre une page utile en deux clics et que les libellés de navigation utilisent des termes que les lecteurs sont susceptibles de rechercher. Envoyez les problèmes de migration à votre représentant Mintlify dans une seule liste, avec l'URL de la page et le résultat attendu.
+Confirmez qu'un nouvel utilisateur peut atteindre une page utile en deux clics et que les libellés de navigation utilisent des termes que les lecteurs sont susceptibles de rechercher. Envoyez les problèmes de migration à votre AE ou SE dans une seule liste, avec l'URL de la page et le résultat attendu.
## Étape 4 : publier une modification
@@ -263,7 +263,7 @@ Ensuite :
2. Ajoutez vos polices via les [paramètres de police](/fr/customize/fonts).
3. Ajoutez une image Open Graph par défaut et testez un lien partagé dans Slack.
-Consultez les [paramètres d'apparence](/fr/organize/settings-appearance), les [thèmes](/fr/customize/themes) et le [SEO](/fr/optimize/seo) pour les autres options. Si vous ne souhaitez pas modifier `docs.json`, envoyez vos éléments de marque à votre représentant Mintlify.
+Consultez les [paramètres d'apparence](/fr/organize/settings-appearance), les [thèmes](/fr/customize/themes) et le [SEO](/fr/optimize/seo) pour les autres options. Si vous ne souhaitez pas modifier `docs.json`, envoyez vos éléments de marque à votre AE ou SE.
## Étape 6 : tester les fonctionnalités d'IA
@@ -389,7 +389,7 @@ Réservez une heure avec votre décideur. Commencez par l'objectif et la valeur
| Les mises à jour automatisées sont utiles | L'historique des exécutions de l'automatisation et la modification proposée. |
| Les exigences de sécurité sont satisfaites | La revue de votre équipe IT. |
-Résolvez les questions en suspens avec votre représentant Mintlify avant cette réunion.
+Résolvez les questions en suspens avec votre AE ou SE avant cette réunion.
## Calendrier suggéré
@@ -403,14 +403,6 @@ La plupart des POC durent deux à trois semaines :
| Semaine 2 | Vérifier le contenu, publier une modification, appliquer l'image de marque, tester l'assistant et évaluer un workflow d'IA. |
| Semaine 3 | Terminer la revue IT et sécurité, puis passer en revue les résultats avec votre décideur. |
-
- 如果遇到困难，请在共享 Slack 频道中联系你的 Mintlify 代表，或发送邮件至 [support@mintlify.com](mailto:support@mintlify.com)。
+ 如果遇到困难，请联系你的客户经理（AE，account executive）或解决方案工程师（SE，solutions engineer），或发送邮件至 [support@mintlify.com](mailto:support@mintlify.com)。
- ## Obtenir de l'aide
-
-
-- Utilisez votre canal Slack partagé pour les questions urgentes liées au POC.
-- Écrivez à [support@mintlify.com](mailto:support@mintlify.com) pour les autres questions.
-- Consultez [Support avancé](/fr/advanced-support) pour les options de support après le POC.
-
## Après le POC
diff --git a/zh/poc-onboarding.mdx b/zh/poc-onboarding.mdx
index 7b36e8f1a..f2d974ea0 100644
--- a/zh/poc-onboarding.mdx
+++ b/zh/poc-onboarding.mdx
@@ -8,7 +8,7 @@ noindex: true
使用本指南搭建一个可运行的文档站点，并与你的团队一起评估 Mintlify。大多数任务在控制面板中完成，但某些步骤需要 GitHub 和 IT 管理员的简短协助。
@@ -44,7 +44,6 @@ noindex: true
| GitHub 管理员 | 批准 Mintlify GitHub 应用。 | 15 分钟 |
| 设计师或品牌负责人 | 提供徽标、颜色和字体。 | 30 分钟 |
| 身份或 IT 管理员 | 配置身份验证和 DNS（如需要）。 | 1 到 2 小时 |
-| 决策者 | 根据你的成功标准审查 POC。 | 1 小时 |
### 收集你的内容和品牌资产
@@ -64,10 +63,11 @@ noindex: true
### 定义成功标准
-选择一个业务目标并记录其当前基线：
+从客户最常用来衡量 Mintlify 的价值驱动因素中选择一个，并记录其当前基线：
- **获客：** 提高激活率或缩短首次集成所需时间。
- **工单转移：** 减少某个常见支持主题的工单数量。
+- **节省工程时间：** 减少工程师在编写、审查和维护文档上花费的时间。
- **留存：** 提高某个功能发布后的采用率。
添加两到三条可以在 POC 期间测试的标准。例如：
@@ -77,7 +77,7 @@ noindex: true
- 助手能正确回答 10 个常见支持问题中的 8 个，并引用正确的页面。
- 你的身份提供商支持控制面板登录。
-将目标、基线和标准分享给你的 Mintlify 代表。
+将目标、基线和标准分享给你的 AE 或 SE。
## 第 1 步：连接你的仓库
@@ -155,7 +155,7 @@ noindex: true
- 询问你的 Mintlify 代表迁移服务是否包含在你的 POC 中。如果包含，请发送：
+ 询问你的 AE 或 SE 迁移服务是否包含在你的 POC 中。如果包含，请发送：
- 你当前文档的 URL 或导出文件。
- 你的示例页面列表。
@@ -191,7 +191,7 @@ noindex: true
- 自定义组件和嵌入内容。
- 导航标签和页面位置。
-确认新用户能在两次点击内到达有用的页面，并且导航标签使用读者可能搜索的术语。将迁移问题整理成一份列表（包含页面 URL 和预期结果）发送给你的 Mintlify 代表。
+确认新用户能在两次点击内到达有用的页面，并且导航标签使用读者可能搜索的术语。将迁移问题整理成一份列表（包含页面 URL 和预期结果）发送给你的 AE 或 SE。
## 第 4 步：发布一次更改
@@ -263,7 +263,7 @@ noindex: true
2. 使用[字体设置](/zh/customize/fonts)添加你的字体。
3. 添加默认的 Open Graph 图片，并在 Slack 中测试分享链接的效果。
-其他选项请参阅[外观设置](/zh/organize/settings-appearance)、[主题](/zh/customize/themes)和 [SEO](/zh/optimize/seo)。如果你不想编辑 `docs.json`，请将资产发送给你的 Mintlify 代表。
+其他选项请参阅[外观设置](/zh/organize/settings-appearance)、[主题](/zh/customize/themes)和 [SEO](/zh/optimize/seo)。如果你不想编辑 `docs.json`，请将资产发送给你的 AE 或 SE。
## 第 6 步：测试 AI 功能
@@ -389,7 +389,7 @@ groups: ["engineering"]
| 自动更新有价值 | 自动化的运行历史和提出的更改。 |
| 满足安全要求 | 你的 IT 团队的审查结果。 |
-在此会议之前，与你的 Mintlify 代表解决所有未决问题。
+在此会议之前，与你的 AE 或 SE 解决所有未决问题。
## 建议时间表
@@ -403,14 +403,6 @@ groups: ["engineering"]
| 第 2 周 | 审查内容、发布一次更改、应用品牌样式、测试助手并评估一个 AI 工作流。 |
| 第 3 周 | 完成 IT 和安全审查，然后与决策者一起审查结果。 |
-
@@ -2478,7 +2478,7 @@ noindex: true
- Delete an org functionality has been added to the dashboard.
- Shipped GitLab connection UI.
- Fix incorrect analytics data.
- - Add-on's can now be directly purchased through the dashboard.
+ - Add-ons can now be directly purchased through the dashboard.
## Bug Fixes
@@ -2564,7 +2564,7 @@ noindex: true
- Create a custom global landing page setup with custom components
- Add full-screen videos or image galleries
- - Embed custom iFrame demo elements to add intractability to your docs
+ - Embed custom iFrame demo elements to add interactivity to your docs
Check out our [Custom Mode docs](organize/pages#custom).
diff --git a/cli/commands.mdx b/cli/commands.mdx
index 3434afd6d..29c2388e7 100644
--- a/cli/commands.mdx
+++ b/cli/commands.mdx
@@ -330,6 +330,10 @@ mint automations delete [flags]
Query documentation analytics from the terminal. Requires authentication with `mint login`.
+
+ Analytics require a [Pro or Enterprise plan](https://mintlify.com/pricing?ref=analytics).
+
+
```bash
mint analytics [flags]
```
diff --git a/cli/index.mdx b/cli/index.mdx
index e3923205f..5f2eeeb91 100644
--- a/cli/index.mdx
+++ b/cli/index.mdx
@@ -39,6 +39,9 @@ Run `mint score` to evaluate how well agents can navigate a documentation site.
### Format MDX files
Run `mint format` to rewrite the MDX files in your project to Mintlify's canonical style. The command walks every subdirectory and reformats files in place.
+### Query analytics
+Run `mint analytics` to view documentation stats, search queries, feedback, and assistant conversations from the terminal. Output defaults to JSON when the CLI detects an AI or CI environment, so agents can pipe results into other tools.
+
### Manage configuration
Run `mint config` to set persistent defaults like your documentation subdomain.
diff --git a/components/update.mdx b/components/update.mdx
index 4edcdd835..f58ddfded 100644
--- a/components/update.mdx
+++ b/components/update.mdx
@@ -37,7 +37,7 @@ Use the `Update` component to display changelog entries, version updates, and re
Use multiple `Update` components to create [changelogs](/create/changelogs).
-Update components automatically generate RSS feed entries. The entries contain pure Markdown only--components, code blocks, inline code, and raw HTML elements are not included.
+Update components automatically generate RSS feed entries. The entries contain pure Markdown only—components, code blocks, inline code, and raw HTML elements are not included.
If your update includes components or HTML, use the `rss` prop to provide alternative text for RSS subscribers.
diff --git a/deploy/rollbacks.mdx b/deploy/rollbacks.mdx
index 73c322c78..9528650f7 100644
--- a/deploy/rollbacks.mdx
+++ b/deploy/rollbacks.mdx
@@ -12,7 +12,7 @@ Roll back your live site to any of your last 10 successful builds. A rollback ch
Use a rollback when a change reaches your live site that you must remove immediately.
-Only organization admins can roll back a deployment.
+Only organization admins can roll back a deployment. The **Roll back** and **Promote** buttons appear only for admins.
## Roll back to a previous build
@@ -24,6 +24,8 @@ Only organization admins can roll back a deployment.
On the **Live** tab, click a successful build to expand it.
Use the commit message and author to help you identify the build that you want to roll back to.
+
+ The most recent successful build does not have a **Roll back** button because your site already serves it.
Click **Roll back**. Your site serves the selected build within seconds.
diff --git a/editor/agent.mdx b/editor/agent.mdx
index a4735a100..3ac724e3b 100644
--- a/editor/agent.mdx
+++ b/editor/agent.mdx
@@ -39,7 +39,9 @@ Supported file types:
- **Documents**: PDF
- **Code and text**: `.js`, `.ts`, `.jsx`, `.tsx`, `.mdx`, `.md`, `.json`, `.yaml`, `.html`, `.css`, Python, Go, Rust, Ruby, Java, Swift, C, C++, SQL, shell scripts, and more
-Maximum size: 5 MB per file. Maximum: 10 files per message.
+Maximum size: 5 MB per file, except SVG files, which are limited to 256 KB. Maximum: 10 files per message.
+
+Mintlify strips scripts and other active content from SVG files before the agent reads them.
## Add a selection to the agent
diff --git a/editor/comments.mdx b/editor/comments.mdx
index aa104b931..8db8f5b98 100644
--- a/editor/comments.mdx
+++ b/editor/comments.mdx
@@ -57,6 +57,20 @@ Type `@` in a comment or reply to mention a teammate. People must be a member of
Mentioned teammates receive an email notification.
+## Ask the Mintlify agent
+
+Mention `@mintlify` in a comment, [suggestion](/editor/suggestions), or reply to ask the [editor agent](/editor/agent) a question about the current page. The agent runs asynchronously with the page, thread, and branch as context, then posts its answer as a new reply in the same thread.
+
+Use `@mintlify` mentions to ask questions like:
+
+- `@mintlify does this endpoint support pagination?`
+- `@mintlify is this the recommended way to configure webhooks?`
+- `@mintlify are there any pages that contradict this?`
+
+The agent runs in read-only mode when replying to comments. It can search your docs, read pages, fetch web content, and load skills, but it cannot edit content, create suggestions, or publish changes. To make changes, open the [editor agent](/editor/agent) directly.
+
+`@mintlify` mentions work on private pages for members who already have access. Each agent reply counts toward your editor agent usage.
+
## Resolve a comment
Editors and admins can resolve threads when a discussion is complete.
diff --git a/editor/settings.mdx b/editor/settings.mdx
index 3f785cb3b..63bda28d5 100644
--- a/editor/settings.mdx
+++ b/editor/settings.mdx
@@ -86,7 +86,7 @@ using its relative path.
When you enable main branch autocommits, the editor commits changes shortly after you stop typing.
-Use this setting when your team edits the deployment branch directly and wants updates to reach Git without a manual publish step. If you want to review changes before they publish to your sire, do not use autocommits.
+Use this setting when your team edits the deployment branch directly and wants updates to reach Git without a manual publish step. If you want to review changes before they publish to your site, do not use autocommits.
Edits on feature branches created from the editor autocommit regardless of this setting. Changes on a feature branch never publish unless you merge them into your deployment branch.
diff --git a/es/cli/commands.mdx b/es/cli/commands.mdx
index fb7ffb0f2..7c9f64e79 100644
--- a/es/cli/commands.mdx
+++ b/es/cli/commands.mdx
@@ -368,6 +368,10 @@ mint automations delete [flags]
Consulta las analíticas de la documentación desde la terminal. Requiere autenticación con `mint login`.
+
+ Las analíticas requieren un [plan Pro o Enterprise](https://mintlify.com/pricing?ref=analytics).
+
+
```bash
mint analytics [flags]
```
diff --git a/es/cli/index.mdx b/es/cli/index.mdx
index 4ff122249..aa840435f 100644
--- a/es/cli/index.mdx
+++ b/es/cli/index.mdx
@@ -51,6 +51,12 @@ Ejecuta `mint score` para evaluar qué tan bien pueden los agentes navegar por u
Ejecuta `mint format` para reescribir los archivos MDX de tu proyecto siguiendo el estilo canónico de Mintlify. El comando recorre cada subdirectorio y reformatea los archivos in situ.
+
- - `nav-logo`—Logo en la barra de navegación.
+ - `nav-logo`—Imagen del logo en la barra de navegación. Para anular sus utilidades de tamaño predeterminadas, apunta a `img.nav-logo` y usa `!important`.
+
+ ```css
+ img.nav-logo {
+ height: 3.75rem !important;
+ width: auto !important;
+ }
+ ```
- `navbar-link`—Elemento de enlace dentro de la barra de navegación.
- `nav-anchors`—Contenedor de enlaces de anclaje en la barra superior.
- `nav-anchor`—Enlace de anclaje individual en la barra superior.
diff --git a/es/editor/agent.mdx b/es/editor/agent.mdx
index aa051225f..055114df8 100644
--- a/es/editor/agent.mdx
+++ b/es/editor/agent.mdx
@@ -49,7 +49,9 @@ Tipos de archivo admitidos:
- **Documentos**: PDF
- **Código y texto**: `.js`, `.ts`, `.jsx`, `.tsx`, `.mdx`, `.md`, `.json`, `.yaml`, `.html`, `.css`, Python, Go, Rust, Ruby, Java, Swift, C, C++, SQL, scripts de shell y más
-Tamaño máximo: 5 MB por archivo. Máximo: 10 archivos por mensaje.
+Tamaño máximo: 5 MB por archivo, excepto los archivos SVG, que están limitados a 256 KB. Máximo: 10 archivos por mensaje.
+
+Mintlify elimina los scripts y otro contenido activo de los archivos SVG antes de que el agente los lea.
- Ve a [mintlify.com/start](https://mintlify.com/start) y completa el proceso de configuración inicial. Durante la configuración, conectarás tu cuenta de GitHub, crearás o seleccionarás un repositorio para tu documentación e instalarás la Aplicación de GitHub para habilitar los despliegues automáticos.
+ Ve a [mintlify.com/start](https://mintlify.com/start) y completa el proceso de configuración inicial. Durante la configuración, asignas un nombre a tu sitio y respondes algunas preguntas sobre cómo planeas usarlo. También puedes conectar tu cuenta de GitHub e instalar la Aplicación de GitHub para habilitar los despliegues automáticos.
+
+ En el paso final de la configuración inicial, describe la documentación que quieres crear. Puedes agregar enlaces a tu sitio existente, subir archivos o seleccionar repositorios de GitHub para usarlos como fuentes. El agente de Mintlify genera un punto de partida para tu documentación mientras observas una vista previa en vivo. Responde las preguntas que haga el agente para refinar el resultado. Para comenzar con contenido de ejemplo, selecciona **Skip, start from a blank template**.
Después de la configuración inicial, tu sitio de documentación se despliega y queda accesible en tu URL `.mintlify.site`.
diff --git a/es/search-index/mcp.mdx b/es/search-index/mcp.mdx
index e3b819be5..c6754dbb0 100644
--- a/es/search-index/mcp.mdx
+++ b/es/search-index/mcp.mdx
@@ -70,7 +70,7 @@ Index aplica los siguientes límites por IP al servidor MCP público:
| Ventana | Límite |
| --- | ---: |
| Por segundo | 10 solicitudes |
-| Por día | 1.000 solicitudes |
+| Por día | 5.000 solicitudes |
Las solicitudes que superan cualquiera de los límites devuelven `429 Too Many Requests`. Espera antes de volver a intentarlo y usa un backoff exponencial para clientes automatizados.
diff --git a/fr/cli/commands.mdx b/fr/cli/commands.mdx
index 3cb771f2e..4389a171a 100644
--- a/fr/cli/commands.mdx
+++ b/fr/cli/commands.mdx
@@ -370,6 +370,10 @@ mint automations delete [flags]
Interrogez les analytics de la documentation depuis le terminal. Nécessite une authentification avec `mint login`.
+
+ Les analytics nécessitent un [plan Pro ou Enterprise](https://mintlify.com/pricing?ref=analytics).
+
+
```bash
mint analytics [flags]
```
diff --git a/fr/cli/index.mdx b/fr/cli/index.mdx
index f222aae2a..a9103cd73 100644
--- a/fr/cli/index.mdx
+++ b/fr/cli/index.mdx
@@ -51,6 +51,12 @@ Exécutez `mint score` pour évaluer dans quelle mesure les agents peuvent navig
Exécutez `mint format` pour réécrire les fichiers MDX de votre projet selon le style canonique de Mintlify. La commande parcourt tous les sous-répertoires et reformate les fichiers sur place.
+
- - `nav-logo`—Logo dans la barre de navigation.
+ - `nav-logo`—Image du logo dans la barre de navigation. Pour remplacer ses utilitaires de taille par défaut, ciblez `img.nav-logo` et utilisez `!important`.
+
+ ```css
+ img.nav-logo {
+ height: 3.75rem !important;
+ width: auto !important;
+ }
+ ```
- `navbar-link`—Élément de lien dans la barre de navigation.
- `nav-anchors`—Conteneur des liens d'ancrage dans la barre supérieure.
- `nav-anchor`—Lien d'ancrage individuel dans la barre supérieure.
diff --git a/fr/editor/agent.mdx b/fr/editor/agent.mdx
index e9b93d3c5..75bcdb1e9 100644
--- a/fr/editor/agent.mdx
+++ b/fr/editor/agent.mdx
@@ -49,7 +49,9 @@ Types de fichiers pris en charge :
- **Documents** : PDF
- **Code et texte** : `.js`, `.ts`, `.jsx`, `.tsx`, `.mdx`, `.md`, `.json`, `.yaml`, `.html`, `.css`, Python, Go, Rust, Ruby, Java, Swift, C, C++, SQL, scripts shell, et plus encore
-Taille maximale : 5 Mo par fichier. Maximum : 10 fichiers par message.
+Taille maximale : 5 Mo par fichier, sauf pour les fichiers SVG, limités à 256 Ko. Maximum : 10 fichiers par message.
+
+Mintlify supprime les scripts et autres contenus actifs des fichiers SVG avant que l'agent ne les lise.
- Accédez à [mintlify.com/start](https://mintlify.com/start) et suivez le processus d'onboarding. Pendant l'onboarding, vous connectez votre compte GitHub, créez ou sélectionnez un référentiel pour votre documentation et installez la GitHub App afin d'activer les déploiements automatiques.
+ Accédez à [mintlify.com/start](https://mintlify.com/start) et suivez le processus d'onboarding. Pendant l'onboarding, vous nommez votre site et répondez à quelques questions sur la façon dont vous prévoyez de l'utiliser. Vous pouvez également connecter votre compte GitHub et installer la GitHub App afin d'activer les déploiements automatiques.
+
+ À la dernière étape de l'onboarding, décrivez la documentation que vous souhaitez créer. Vous pouvez ajouter des liens vers votre site existant, téléverser des fichiers ou sélectionner des référentiels GitHub à utiliser comme sources. L'agent Mintlify génère un point de départ pour votre documentation pendant que vous suivez un aperçu en direct. Répondez aux questions posées par l'agent pour affiner le résultat. Pour commencer avec du contenu d'exemple, sélectionnez **Skip, start from a blank template**.
Après l'onboarding, votre site de documentation est déployé et accessible via l'URL `.mintlify.site` de votre site.
diff --git a/fr/search-index/mcp.mdx b/fr/search-index/mcp.mdx
index 9740e34b4..b3b21e69a 100644
--- a/fr/search-index/mcp.mdx
+++ b/fr/search-index/mcp.mdx
@@ -70,7 +70,7 @@ Index applique les limites par adresse IP suivantes au serveur MCP public :
| Fenêtre | Limite |
| --- | ---: |
| Par seconde | 10 requêtes |
-| Par jour | 1 000 requêtes |
+| Par jour | 5 000 requêtes |
Les requêtes dépassant l’une ou l’autre limite renvoient `429 Too Many Requests`. Attendez avant de réessayer et utilisez un back-off exponentiel pour les clients automatisés.
diff --git a/migration/fern.mdx b/migration/fern.mdx
index 0a6931aad..0d82dd029 100644
--- a/migration/fern.mdx
+++ b/migration/fern.mdx
@@ -1,6 +1,6 @@
---
title: "Migrate from Fern"
-description: "Migrate a Fern to Mintlify. Convert MDX content, docs.yml navigation, products, versions, assets, API references, and components."
+description: "Migrate a Fern site to Mintlify. Convert MDX content, docs.yml navigation, products, versions, assets, API references, and components."
keywords: ["Fern migration", "Fern to Mintlify", "docs.yml", "Fern Docs"]
---
diff --git a/optimize/seo.mdx b/optimize/seo.mdx
index b36308afb..0c4167e92 100644
--- a/optimize/seo.mdx
+++ b/optimize/seo.mdx
@@ -187,7 +187,7 @@ canonical: "https://docs.example.com/latest/my-page"
```
- Always verify canonical URL behavior on your deployed site. Local builds add `/src/_props` to URLs as an artifact that are not part of the canonical URL.
+ Always verify canonical URL behavior on your deployed site. Local builds add `/src/_props` to URLs as an artifact that is not part of the canonical URL.
## Page-specific meta tags
diff --git a/poc-onboarding.mdx b/poc-onboarding.mdx
index fa4cb0659..14733a9e8 100644
--- a/poc-onboarding.mdx
+++ b/poc-onboarding.mdx
@@ -23,8 +23,7 @@ Complete these steps in order:
| 4. Publish a change | Verify your writing and review workflow. |
| 5. Apply branding | Match the site to your product. |
| 6. Test AI features | Evaluate assistant answers and one AI workflow. |
-| 7. Review IT and security requirements | Confirm authentication and compliance requirements. |
-| 8. Review results | Compare the POC against your success criteria. |
+| 7. Review results | Compare the POC against your success criteria. |
Your repository remains the source of truth. The dashboard lets you edit, configure, and publish the `.mdx` files and `docs.json` configuration in that repository. Your live site displays the published result.
@@ -37,7 +36,7 @@ Your repository remains the source of truth. The dashboard lets you edit, config
| Documentation owner | Runs the POC and completes most steps. | A few hours total |
| GitHub administrator | Approves the Mintlify GitHub App. | 15 minutes |
| Designer or brand owner | Provides logos, colors, and fonts. | 30 minutes |
-| Identity or IT administrator | Configures authentication and DNS, if required. | 1 to 2 hours |
+| Identity or IT administrator | Configures DNS for a custom domain, if you test authentication. | 1 to 2 hours |
### Gather your content and brand assets
@@ -103,7 +102,7 @@ Share the goal, baseline, and criteria with your AE or SE.
-Use the `.mintlify.site` URL during the POC unless you need to test authentication. Authentication requires a custom domain or `*.mintlify.app` subdomain.
+Use the `.mintlify.site` URL during the POC unless you need to test authentication. Authentication requires a [custom domain](/customize/custom-domain) or `*.mintlify.app` subdomain, and does not work on a custom basepath such as `yourcompany.com/docs`.
## Step 2: Invite your team
@@ -115,7 +114,7 @@ Open the [Members](https://app.mintlify.com/settings/organization/members) page
See [Roles](/dashboard/roles) for a complete permissions list.
-Invite at least one writer who does not use Git, one engineer, and the decision maker. Use their work email addresses so their accounts can connect to your identity provider during step 7.
+Invite at least one writer who does not use Git, one engineer, and the decision maker. Use their work email addresses so their accounts can connect to your identity provider.
## Step 3: Add sample content
@@ -282,55 +281,7 @@ Choose the workflow most relevant to your evaluation:
-## Step 7: Review IT and security requirements
-
-Bring your IT or security team into the POC before the final review.
-
-
- Site authentication does not work on the default `.mintlify.site` URL or on a custom basepath such as `yourcompany.com/docs`. Use a custom domain or `*.mintlify.app` subdomain.
-
-
-### Control dashboard access
-
-Evaluate the controls your team requires:
-
-- [Single sign-on](/dashboard/sso) with SAML or OIDC.
-- [SCIM provisioning](/dashboard/scim).
-- [Network access policies](/dashboard/network-access).
-- [Audit logs](/dashboard/audit-logs) and [session security](/dashboard/session-security).
-
-### Control documentation access
-
-Configure [authentication](/deploy/authentication-setup) for your readers:
-
-- **Password:** Quick access control for a POC.
-- **Mintlify-managed access:** Uses your dashboard organization as the user list.
-- **OAuth 2.0:** Connects to your identity provider.
-- **JWT:** Supports custom programmatic access models.
-
-Use [groups](/deploy/authentication-setup#control-access-with-groups) to restrict specific pages:
-
-```yaml
----
-title: "Production runbook"
-groups: ["engineering"]
----
-```
-
-Test with one account in the group and one account outside it.
-
-
- `hidden: true` removes a page from navigation but does not restrict access. Use authentication and groups for access control. See [Hidden pages](/organize/hidden-pages).
-
-
-### Complete infrastructure and compliance checks
-
-- Add a [custom domain](/customize/custom-domain). Use a test subdomain during the POC.
-- Connect your [analytics platform](/integrations/analytics/overview).
-- Enable [CI checks](/deploy/ci) for links and accessibility.
-- Share [Enterprise contracting](/enterprise-contracting) with security and procurement teams.
-
-## Step 8: Review results
+## Step 7: Review results
Book one hour with your decision maker. Start with the goal and baseline you defined before the POC, then review:
@@ -343,7 +294,6 @@ Book one hour with your decision maker. Start with the goal and baseline you def
| Content gaps are identifiable | Unanswered and downvoted questions in [Assistant analytics](/analytics/assistant). |
| Readers find useful content | [Traffic](/analytics/traffic), [search](/analytics/search), and [engagement](/analytics/user-engagements) data. |
| Automated updates are useful | The automation run history and proposed change. |
-| Security requirements are met | Your IT team's review. |
Resolve open questions with your AE or SE before this meeting.
@@ -355,7 +305,13 @@ Most POCs take two to three weeks:
|---|---|
| Week 1 | Connect the repository, invite your team, define success, and start the content migration. Start domain setup if you need authentication. |
| Week 2 | Review content, publish a change, apply branding, test the assistant, and evaluate one AI workflow. |
-| Week 3 | Complete the IT and security review, then review the results with your decision maker. |
+| Week 3 | Review the results with your decision maker. |
+
+## Get help
+
+- Contact your AE or SE for time-sensitive POC questions.
+- Email [support@mintlify.com](mailto:support@mintlify.com) for other questions.
+- See [Advanced support](/advanced-support) for post-POC support options.
## After the POC
diff --git a/quickstart.mdx b/quickstart.mdx
index 8fe1e05a5..49eb0193c 100644
--- a/quickstart.mdx
+++ b/quickstart.mdx
@@ -59,7 +59,9 @@ When you connect your documentation repository to your project, you can work on
## Deploy your documentation site
- Go to [mintlify.com/start](https://mintlify.com/start) and complete the onboarding process. During onboarding, you'll connect your GitHub account, create or select a repository for your documentation, and install the GitHub App to enable automatic deployments.
+ Go to [mintlify.com/start](https://mintlify.com/start) and complete the onboarding process. During onboarding, you name your site and answer a few questions about how you plan to use it. You can also connect your GitHub account and install the GitHub App to enable automatic deployments.
+
+ In the final onboarding step, describe the docs that you want to build. You can add links to your existing site, upload files, or select GitHub repositories to use as sources. The Mintlify agent generates a starting point for your docs while you watch a live preview. Answer any questions the agent asks to refine the result. To start with placeholder content instead, select **Skip, start from a blank template**.
After onboarding, your documentation site deploys and is accessible at your `.mintlify.site` URL.
diff --git a/search-index/mcp.mdx b/search-index/mcp.mdx
index 11f597240..115d6c44d 100644
--- a/search-index/mcp.mdx
+++ b/search-index/mcp.mdx
@@ -64,7 +64,7 @@ Index applies the following per-IP limits to the public MCP server:
| Window | Limit |
| --- | ---: |
| Per second | 10 requests |
-| Per day | 1,000 requests |
+| Per day | 5,000 requests |
Requests exceeding either limit return `429 Too Many Requests`. Wait before retrying, and use exponential backoff for automated clients.
diff --git a/snippets/es/setup-agent-prompt.mdx b/snippets/es/setup-agent-prompt.mdx
index 1de34e6d6..92d431770 100644
--- a/snippets/es/setup-agent-prompt.mdx
+++ b/snippets/es/setup-agent-prompt.mdx
@@ -1,7 +1,7 @@
{/* vale off */}
-Pon mi documentación en línea en un sitio de Mintlify publicado. Habrás terminado con éxito cuando me des la URL en vivo y confirmes que carga. Dime claramente cuando algún paso necesite mi intervención—haz todo lo demás por tu cuenta. Si este prompt se pegó antes (por ejemplo, después de un reinicio), continúa desde donde te quedaste en lugar de empezar de cero. Si no tienes acceso a la terminal o a la ejecución de comandos, dime que siga los pasos manuales en [mintlify.com/start](https://mintlify.com/start) en su lugar. Todo lo siguiente requiere ejecutar comandos y necesita Node.js v 20.17.0+ (se recomiendan versiones LTS).
+Pon mi documentación en línea en un sitio de Mintlify publicado. Habrás terminado con éxito cuando me des la URL en vivo y confirmes que carga. Dime claramente cuando algún paso necesite mi intervención—haz todo lo demás por tu cuenta. Si este prompt se pegó antes (por ejemplo, después de un reinicio), continúa desde donde te quedaste en lugar de empezar de cero. Si no tienes acceso a la terminal o a la ejecución de comandos, dime que siga los pasos manuales en [mintlify.com/start](https://mintlify.com/start) en su lugar. Todo lo siguiente requiere ejecutar comandos y necesita Node.js v20.17.0+ (se recomiendan versiones LTS).
1. Pídeme el contenido existente que se usará para mi sitio de Mintlify. Puede ser una carpeta local o un repositorio. Verifica la fuente antes de construir: repite exactamente qué estás leyendo y muestra el contenido de nivel superior para que yo pueda confirmar que es correcto. Si no puedes acceder a algo que mencioné (los repositorios privados devuelven 404, igual que los inexistentes), detente y pregunta. Nunca sustituyas por una fuente diferente.
2. Comprueba si `mint` está instalado con `mint --version`. Si no lo está, instálalo con `npm i -g mint` (o `pnpm add -g mint`). Si ya está instalado, ejecuta `mint update` en lugar de reinstalarlo.
@@ -17,7 +17,7 @@ Pon mi documentación en línea en un sitio de Mintlify publicado. Habrás termi
10. Haz commit y push de tus cambios. Mintlify se despliega automáticamente al hacer push.
11. Requiere mi intervención: si quiero un dominio personalizado, ejecuta `mint add-domain `. Imprime los registros DNS que necesito añadir con mi proveedor de dominio. Dime cuáles son los registros DNS, ya que solo yo puedo configurarlos con mi registrador. Deja claro que este es un paso que debo completar yo.
12. Confirma que mi sitio está activo: obtén `https://.mintlify.site` (encuentra el subdominio con `mint status`) y confirma que carga. Si agregué un dominio personalizado en el paso 11, obtén también ese dominio y confirma que carga antes de dar por completado este paso—la propagación de DNS puede tardar, así que reintenta varias veces antes de tratar una petición fallida como un error.
-13. Prepárate para seguir trabajando aquí: instala la [skill de Mintlify](https://mintlify.com/docs/ai/skillmd.md) con `npx skills add https://mintlify.com/docs`, y luego registra el [servidor MCP de administración](https://mintlify.com/docs//ai/model-context-protocol.md) en `https://mcp.mintlify.com` para tu herramienta específica. Por ejemplo, `claude mcp add --transport http mintlify https://mcp.mintlify.com` para Claude Code, u obtén https://mintlify.com/docs/ai/mintlify-mcp.md para ver las instrucciones para Claude, Cursor, Codex o ChatGPT. Haz este paso por tu cuenta—no me pidas que ejecute estos comandos.
+13. Prepárate para seguir trabajando aquí: instala la [skill de Mintlify](https://mintlify.com/docs/ai/skillmd.md) con `npx skills add https://mintlify.com/docs`, y luego registra el [servidor MCP de administración](https://mintlify.com/docs/ai/model-context-protocol.md) en `https://mcp.mintlify.com` para tu herramienta específica. Por ejemplo, `claude mcp add --transport http mintlify https://mcp.mintlify.com` para Claude Code, u obtén https://mintlify.com/docs/ai/mintlify-mcp.md para ver las instrucciones para Claude, Cursor, Codex o ChatGPT. Haz este paso por tu cuenta—no me pidas que ejecute estos comandos.
14. Requiere mi intervención: la primera llamada a una herramienta del MCP de administración abre una ventana del navegador para el inicio de sesión con OAuth. Apruébalo allí. La mayoría de las herramientas no cargan servidores MCP recién añadidos a mitad de sesión—si las herramientas de Mintlify no aparecen, dime que te reinicie y retomaremos desde aquí.
15. Si algún comando falla de una forma que no está cubierta arriba, detente y dime el error exacto en lugar de adivinar o reintentar a ciegas. Si parece que algo va mal por el lado de Mintlify y no por lo que estás haciendo, consulta https://status.mintlify.com o remíteme a https://mintlify.com/docs/contact-support.
diff --git a/snippets/fr/setup-agent-prompt.mdx b/snippets/fr/setup-agent-prompt.mdx
index d5da9e75c..7aa35d831 100644
--- a/snippets/fr/setup-agent-prompt.mdx
+++ b/snippets/fr/setup-agent-prompt.mdx
@@ -1,7 +1,7 @@
{/* vale off */}
-Mettez ma documentation en ligne sur un site Mintlify publié. Vous avez terminé avec succès lorsque vous me donnez l'URL en direct et confirmez qu'elle se charge. Dites-moi clairement chaque fois qu'une étape nécessite mon intervention—faites tout le reste vous-même. Si ce prompt a déjà été collé (par exemple, après un redémarrage), reprenez là où vous vous étiez arrêté au lieu de recommencer depuis le début. Si vous n'avez pas accès au terminal ou à l'exécution de commandes, dites-moi de suivre les étapes manuelles sur [mintlify.com/start](https://mintlify.com/start) à la place. Tout ce qui suit nécessite d'exécuter des commandes et requiert Node.js v 20.17.0+ (les versions LTS sont recommandées).
+Mettez ma documentation en ligne sur un site Mintlify publié. Vous avez terminé avec succès lorsque vous me donnez l'URL en direct et confirmez qu'elle se charge. Dites-moi clairement chaque fois qu'une étape nécessite mon intervention—faites tout le reste vous-même. Si ce prompt a déjà été collé (par exemple, après un redémarrage), reprenez là où vous vous étiez arrêté au lieu de recommencer depuis le début. Si vous n'avez pas accès au terminal ou à l'exécution de commandes, dites-moi de suivre les étapes manuelles sur [mintlify.com/start](https://mintlify.com/start) à la place. Tout ce qui suit nécessite d'exécuter des commandes et requiert Node.js v20.17.0+ (les versions LTS sont recommandées).
1. Demandez-moi le contenu existant qui sera utilisé pour mon site Mintlify. Il peut s'agir d'un dossier local ou d'un référentiel. Vérifiez la source avant de construire : reproduisez exactement ce que vous lisez et listez son contenu de niveau supérieur afin que je puisse confirmer qu'il est correct. Si vous ne pouvez pas accéder à quelque chose que j'ai indiqué (les référentiels privés renvoient 404, tout comme ceux qui n'existent pas), arrêtez-vous et demandez. Ne substituez jamais une autre source.
2. Vérifiez si `mint` est installé avec `mint --version`. S'il est absent, installez-le avec `npm i -g mint` (ou `pnpm add -g mint`). S'il est déjà installé, exécutez `mint update` au lieu de le réinstaller.
@@ -17,7 +17,7 @@ Mettez ma documentation en ligne sur un site Mintlify publié. Vous avez termin
10. Faites un commit et un push de vos changements. Mintlify se déploie automatiquement lors du push.
11. Nécessite mon intervention : si je veux un domaine personnalisé, exécutez `mint add-domain `. Cette commande imprime les enregistrements DNS que je dois ajouter chez mon fournisseur de domaine. Indiquez-moi les enregistrements DNS, car moi seul peux les configurer chez mon bureau d'enregistrement. Précisez clairement qu'il s'agit d'une étape que je dois effectuer.
12. Confirmez que mon site est en ligne : récupérez `https://.mintlify.site` (trouvez le sous-domaine via `mint status`) et confirmez qu'il se charge. Si j'ai ajouté un domaine personnalisé à l'étape 11, récupérez également ce domaine et confirmez qu'il se charge avant de considérer cette étape comme terminée — la propagation DNS peut prendre du temps, réessayez donc plusieurs fois avant de considérer un échec de récupération comme une erreur.
-13. Préparez-vous à continuer à travailler ici : installez la [skill Mintlify](https://mintlify.com/docs/ai/skillmd.md) avec `npx skills add https://mintlify.com/docs`, puis enregistrez le [serveur MCP d'administration](https://mintlify.com/docs//ai/model-context-protocol.md) à l'adresse `https://mcp.mintlify.com` pour votre outil spécifique. Par exemple, `claude mcp add --transport http mintlify https://mcp.mintlify.com` pour Claude Code, ou récupérez https://mintlify.com/docs/ai/mintlify-mcp.md pour obtenir les instructions pour Claude, Cursor, Codex ou ChatGPT. Faites cette étape vous-même—ne me demandez pas d'exécuter ces commandes.
+13. Préparez-vous à continuer à travailler ici : installez la [skill Mintlify](https://mintlify.com/docs/ai/skillmd.md) avec `npx skills add https://mintlify.com/docs`, puis enregistrez le [serveur MCP d'administration](https://mintlify.com/docs/ai/model-context-protocol.md) à l'adresse `https://mcp.mintlify.com` pour votre outil spécifique. Par exemple, `claude mcp add --transport http mintlify https://mcp.mintlify.com` pour Claude Code, ou récupérez https://mintlify.com/docs/ai/mintlify-mcp.md pour obtenir les instructions pour Claude, Cursor, Codex ou ChatGPT. Faites cette étape vous-même—ne me demandez pas d'exécuter ces commandes.
14. Nécessite mon intervention : le premier appel d'outil MCP d'administration ouvre une fenêtre du navigateur pour la connexion OAuth. Approuvez-la là. La plupart des outils ne chargent pas les serveurs MCP nouvellement ajoutés en cours de session — si les outils Mintlify n'apparaissent pas, dites-moi de vous redémarrer et nous reprendrons ici.
15. Si une commande échoue d'une manière non couverte ci-dessus, arrêtez-vous et donnez-moi l'erreur exacte au lieu de deviner ou de réessayer à l'aveugle. S'il semble que le problème vient du côté de Mintlify plutôt que de ce que vous faites, consultez https://status.mintlify.com ou renvoyez-moi vers https://mintlify.com/docs/contact-support.
diff --git a/snippets/icons-optional.mdx b/snippets/icons-optional.mdx
index 530840252..9bbcd9668 100644
--- a/snippets/icons-optional.mdx
+++ b/snippets/icons-optional.mdx
@@ -11,10 +11,10 @@
For custom SVG icons:
1. Convert your SVG using the [SVGR converter](https://react-svgr.com/playground/).
- 1. Paste your SVG code into the SVG input field.
- 2. Copy the complete `` element from the JSX output field.
- 3. Wrap the JSX-compatible SVG code in curly braces: `icon={}`.
- 4. Adjust `height` and `width` as needed.
+ 2. Paste your SVG code into the SVG input field.
+ 3. Copy the complete `` element from the JSX output field.
+ 4. Wrap the JSX-compatible SVG code in curly braces: `icon={}`.
+ 5. Adjust `height` and `width` as needed.
diff --git a/snippets/zh/setup-agent-prompt.mdx b/snippets/zh/setup-agent-prompt.mdx
index 55312916b..73fdaba64 100644
--- a/snippets/zh/setup-agent-prompt.mdx
+++ b/snippets/zh/setup-agent-prompt.mdx
@@ -1,7 +1,7 @@
{/* vale off */}
-让我的文档在已发布的 Mintlify 站点上正式上线。当你把在线 URL 给我并确认它能加载时，就算成功完成任务。当某个步骤需要我参与时，请清楚地告诉我——其他所有事情请你自己完成。如果这个提示词之前已经被粘贴过（例如在重启之后），请从上次中断的地方继续，而不是从头开始。如果你没有终端或命令执行权限，请告诉我改为在 [mintlify.com/start](https://mintlify.com/start) 按照手动步骤操作。以下所有步骤都需要执行命令，并且需要 Node.js v 20.17.0+（建议使用 LTS 版本）。
+让我的文档在已发布的 Mintlify 站点上正式上线。当你把在线 URL 给我并确认它能加载时，就算成功完成任务。当某个步骤需要我参与时，请清楚地告诉我——其他所有事情请你自己完成。如果这个提示词之前已经被粘贴过（例如在重启之后），请从上次中断的地方继续，而不是从头开始。如果你没有终端或命令执行权限，请告诉我改为在 [mintlify.com/start](https://mintlify.com/start) 按照手动步骤操作。以下所有步骤都需要执行命令，并且需要 Node.js v20.17.0+（建议使用 LTS 版本）。
1. 询问我用于 Mintlify 站点的现有内容。它可以是本地文件夹或一个仓库。构建之前请先核对来源：把你正在读取的内容原样回显给我，并列出其顶层目录内容，以便我确认无误。如果你无法访问我指定的内容（私有仓库会返回 404，与不存在的仓库相同），请停下来询问我。绝对不要用其他来源替代。
2. 使用 `mint --version` 检查是否已安装 `mint`。如果没有，请用 `npm i -g mint`（或 `pnpm add -g mint`）进行安装。如果已经安装，请运行 `mint update` 而不是重新安装。
@@ -17,7 +17,7 @@
10. 提交并推送你的更改。Mintlify 会在推送时自动部署。
11. 需要我参与：如果我想使用自定义域名，请运行 `mint add-domain <域名>`。该命令会打印出我需要在域名服务商处添加的 DNS 记录。请把 DNS 记录告诉我，因为只有我可以在域名注册商处配置这些记录。请明确告诉我这是我必须完成的步骤。
12. 确认我的站点已上线：请获取 `https://<子域名>.mintlify.site`（通过 `mint status` 查找子域名）并确认可以加载。如果我在第 11 步添加了自定义域名，也请获取该域名并确认可以加载，然后再把这一步标记为完成——DNS 传播可能会延迟，所以在把一次获取失败当作错误之前，请多重试几次。
-13. 为在这里持续工作做好准备：使用 `npx skills add https://mintlify.com/docs` 安装 [Mintlify skill](https://mintlify.com/docs/ai/skillmd.md)，然后在 `https://mcp.mintlify.com` 为你使用的具体工具注册 [admin MCP 服务器](https://mintlify.com/docs//ai/model-context-protocol.md)。例如，对于 Claude Code 使用 `claude mcp add --transport http mintlify https://mcp.mintlify.com`，或者获取 https://mintlify.com/docs/ai/mintlify-mcp.md 以查看针对 Claude、Cursor、Codex 或 ChatGPT 的说明。这一步请你自己完成——不要让我来运行这些命令。
+13. 为在这里持续工作做好准备：使用 `npx skills add https://mintlify.com/docs` 安装 [Mintlify skill](https://mintlify.com/docs/ai/skillmd.md)，然后在 `https://mcp.mintlify.com` 为你使用的具体工具注册 [admin MCP 服务器](https://mintlify.com/docs/ai/model-context-protocol.md)。例如，对于 Claude Code 使用 `claude mcp add --transport http mintlify https://mcp.mintlify.com`，或者获取 https://mintlify.com/docs/ai/mintlify-mcp.md 以查看针对 Claude、Cursor、Codex 或 ChatGPT 的说明。这一步请你自己完成——不要让我来运行这些命令。
14. 需要我参与：第一次调用 admin MCP 工具时会打开一个浏览器窗口进行 OAuth 登录。请在那里批准。大多数工具在会话中途不会加载新添加的 MCP 服务器——如果 Mintlify 相关工具没有出现，请告诉我重新启动你，然后我们从这里继续。
15. 如果任何命令以上文未涵盖的方式失败，请停下来告诉我确切的错误信息，而不是随便猜测或盲目重试。如果看起来问题出在 Mintlify 一侧而不是你所做的事情上，请查看 https://status.mintlify.com 或引导我前往 https://mintlify.com/docs/contact-support。
diff --git a/zh/cli/commands.mdx b/zh/cli/commands.mdx
index 5daa37d42..11bc4d14c 100644
--- a/zh/cli/commands.mdx
+++ b/zh/cli/commands.mdx
@@ -370,6 +370,10 @@ mint automations delete [flags]
从终端查询文档分析数据。需要使用 `mint login` 进行身份验证。
+
+ 分析功能需要 [Pro 或 Enterprise 计划](https://mintlify.com/pricing?ref=analytics)。
+
+
```bash
mint analytics [flags]
```
diff --git a/zh/cli/index.mdx b/zh/cli/index.mdx
index fa5b7a0bc..a9cfe01e3 100644
--- a/zh/cli/index.mdx
+++ b/zh/cli/index.mdx
@@ -51,6 +51,12 @@ CLI 在你的本地机器上运行，在需要实时数据时连接到你的 Min
运行 `mint format` 将项目中的 MDX 文件重写为 Mintlify 的规范样式。该命令会遍历所有子目录，并就地重新格式化文件。
+
- - `nav-logo`—导航栏中的 Logo。
+ - `nav-logo`—导航栏中的 logo 图片。要覆盖其默认的尺寸工具类，请选中 `img.nav-logo` 并使用 `!important`。
+
+ ```css
+ img.nav-logo {
+ height: 3.75rem !important;
+ width: auto !important;
+ }
+ ```
- `navbar-link`—导航栏内的链接元素。
- `nav-anchors`—顶栏中锚点链接的容器。
- `nav-anchor`—顶栏中的单个锚点链接。
diff --git a/zh/editor/agent.mdx b/zh/editor/agent.mdx
index 28f488787..ca747caaa 100644
--- a/zh/editor/agent.mdx
+++ b/zh/editor/agent.mdx
@@ -43,7 +43,9 @@ keywords: ["编辑器", "AI", "助手", "代理", "聊天", "评论", "建议",
- **文档**：PDF
- **代码和文本**：`.js`、`.ts`、`.jsx`、`.tsx`、`.mdx`、`.md`、`.json`、`.yaml`、`.html`、`.css`、Python、Go、Rust、Ruby、Java、Swift、C、C++、SQL、shell 脚本等
-最大大小：每个文件 5 MB。最多：每条消息 10 个文件。
+最大大小：每个文件 5 MB，SVG 文件除外，其上限为 256 KB。最多：每条消息 10 个文件。
+
+在代理读取 SVG 文件之前，Mintlify 会移除其中的脚本和其他活动内容。
- 前往 [mintlify.com/start](https://mintlify.com/start) 并完成初始设置流程。在初始设置过程中，你会连接你的 GitHub 账户，为文档创建或选择一个存储库，并安装 GitHub 应用以启用自动部署。
+ 前往 [mintlify.com/start](https://mintlify.com/start) 并完成初始设置流程。在初始设置过程中，你需要为站点命名，并回答几个关于使用计划的问题。你还可以连接你的 GitHub 账户并安装 GitHub 应用以启用自动部署。
+
+ 在初始设置的最后一步，描述你想要构建的文档。你可以添加现有网站的链接、上传文件，或选择 GitHub 存储库作为资料来源。Mintlify 智能体会为你的文档生成一个起点，你可以通过实时预览查看进度。回答智能体提出的问题以完善生成结果。若想从占位内容开始，请选择 **Skip, start from a blank template**。
完成初始设置后，你的文档站点会完成部署，并可通过 `.mintlify.site` URL 访问。
diff --git a/zh/search-index/mcp.mdx b/zh/search-index/mcp.mdx
index 5c8905d14..6c4a14f15 100644
--- a/zh/search-index/mcp.mdx
+++ b/zh/search-index/mcp.mdx
@@ -70,7 +70,7 @@ Index 对公开 MCP 服务器实施以下按 IP 计算的限制：
| 时间窗口 | 限制 |
| --- | ---: |
| 每秒 | 10 个请求 |
-| 每天 | 1,000 个请求 |
+| 每天 | 5,000 个请求 |
超过任一限制的请求会返回 `429 Too Many Requests`。请等待后重试，自动化客户端应使用指数退避。
From 8804c58d3eeafd958060ef8868e141d9dc26c431 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Tue, 25 Aug 2026 19:58:00 +0000
Subject: [PATCH 6/8] docs: sync branch with main llms index and translation
updates
---
ai/llmstxt.mdx | 25 ++++++++++---
deploy/reverse-proxy.mdx | 17 +++++++++
es/poc-onboarding.mdx | 78 ++++++++--------------------------------
fr/poc-onboarding.mdx | 78 ++++++++--------------------------------
zh/poc-onboarding.mdx | 78 ++++++++--------------------------------
5 files changed, 80 insertions(+), 196 deletions(-)
diff --git a/ai/llmstxt.mdx b/ai/llmstxt.mdx
index 58fb21916..c362042e1 100644
--- a/ai/llmstxt.mdx
+++ b/ai/llmstxt.mdx
@@ -55,11 +55,28 @@ Both `llms.txt` and `llms-full.txt` list pages from your default language and de
This structured approach allows LLMs to efficiently process your documentation at a high level and locate relevant content for user queries, improving the accuracy and speed of AI-assisted documentation searches.
-
- Automatically generated `llms.txt` index files cannot exceed 100,000 characters. For large documentation sites, Mintlify splits the index into linked files under `/_llms/` so agents can discover every page without loading one oversized file. This limit does not apply to `llms-full.txt`.
-
+## Split indexes under `/_llms`
+
+Automatically generated `llms.txt` index files cannot exceed 100,000 characters. When an index is larger than this limit, Mintlify keeps the main `llms.txt` file as a directory and moves groups of page links into generated Markdown files under `/_llms/`. This limit does not apply to `llms-full.txt`.
+
+For example, a large site might link to the following generated index:
+
+```mdx
+- [API reference](https://docs.example.com/_llms/api-reference.md)
+```
+
+Agents should follow these index links recursively until they reach documentation page links. The generated files are part of `llms.txt` and do not need to exist in your repository. They are separate from `llms-full.txt`.
+
+The `/_llms/` route uses the same base path as your documentation:
+
+- A root-hosted site serves an index at `https://docs.example.com/_llms/api-reference.md`.
+- A site hosted at `/docs` serves it at `https://example.com/docs/_llms/api-reference.md`.
+
+If you use a reverse proxy or path allowlist, forward the generated route in addition to `llms.txt`. A broad `/*` rule already includes `/_llms/*`. With granular rules, add `/_llms/*` explicitly. See [Reverse proxy](/deploy/reverse-proxy#routing-configuration) for routing guidance.
-If you use a reverse proxy or maintain a path allowlist, forward `/_llms/*` in addition to `/llms.txt` so agents can follow the generated index links. For documentation hosted at a base path, forward `/_llms/*` instead. Mintlify-managed custom domains do not require additional configuration. See [Reverse proxy](/deploy/reverse-proxy#routing-configuration) for routing guidance.
+
+ A directory such as `/docs` in your repository does not set your site's public base path. Configure the base path in your Mintlify dashboard and use the same prefix in your reverse proxy. Otherwise, `llms.txt` can be reachable at the public prefix while its generated `/_llms/` links point somewhere else.
+
```mdx Example llms.txt
# Site title
diff --git a/deploy/reverse-proxy.mdx b/deploy/reverse-proxy.mdx
index dce227f18..845ea2c70 100644
--- a/deploy/reverse-proxy.mdx
+++ b/deploy/reverse-proxy.mdx
@@ -14,6 +14,8 @@ When you implement a reverse proxy, monitor for potential issues with domain ver
Set your base path on the [Custom domain setup](https://app.mintlify.com/settings/deployment/custom-domain) page in your dashboard. Then configure your reverse proxy to route that path to Mintlify. The default base path is `/docs`, but you can use any base path you choose, like `/help` or `/resources`.
+The directory that contains your documentation in your repository does not configure the public base path. For example, storing documentation under a `/docs` directory does not replace setting `/docs` as the base path in your dashboard.
+
In all configurations, use `mintlify.site` as the proxy target.
## Host at `/docs` subpath
@@ -40,6 +42,7 @@ Proxy these paths to your Mintlify subdomain:
| --------------------------------- | ------------------------------------ | -------- |
| `/docs` | `.mintlify.site/docs` | No cache |
| `/docs/*` | `.mintlify.site/docs/*` | No cache |
+| `/docs/_llms/*` | `.mintlify.site/docs/_llms/*` | No cache |
| `/.well-known/vercel/*` | `.mintlify.site/.well-known/vercel/*` | No cache |
| `/.well-known/skills/*` (optional) | `.mintlify.site/docs/.well-known/skills/*` | No cache |
| `/.well-known/agent-skills/*` (optional) | `.mintlify.site/docs/.well-known/agent-skills/*` | No cache |
@@ -53,6 +56,8 @@ Mintlify serves these files under your base path, like `.mintlif
The `/docs/*` route also covers generated `llms.txt` indexes under `/docs/_llms/*`. If your proxy uses a more granular path allowlist instead of forwarding all `/docs/*` requests, include `/docs/_llms/*` so agents can follow every index linked from `/docs/llms.txt`.
+Do not rewrite only `/docs/llms.txt` to a root-hosted `/llms.txt`. Set `/docs` as the deployment base path and forward the full `/docs/*` route. This keeps page links and generated `/docs/_llms/*` index links on the same public prefix.
+
The `/.well-known/skills/*`, `/.well-known/agent-skills/*`, `/skill.md`, `/llms.txt`, and `/llms-full.txt` routes are optional. Include them only if you also want to serve these files at root paths on your domain, like `your-domain.com/llms.txt`. Each root path maps to the file under your base path on your Mintlify subdomain.
### Required header configuration
@@ -204,6 +209,18 @@ Configure your reverse proxy using the same [routing configuration](#routing-con
- Remove `Host` header forwarding.
- Set the `Origin` header to your Mintlify subdomain (`.mintlify.site`).
+### Generated `/_llms/` links return 404
+
+**Symptoms**: Your `llms.txt` file loads, but links under `/_llms/` return 404 or omit your public subpath.
+
+**Cause**: The public subpath does not match the base path configured in Mintlify, or the proxy only forwards `llms.txt` and not its generated index routes.
+
+**Solution**:
+
+- Set the public subpath as the base path in your Mintlify dashboard. A repository directory with the same name does not configure it.
+- Forward the full `/*` route, or add `/_llms/*` to a granular allowlist.
+- Redeploy your documentation, then verify both `/llms.txt` and one linked `/_llms/*.md` URL.
+
### Performance issues
**Symptoms**: Slow page loads and layout shifts.
diff --git a/es/poc-onboarding.mdx b/es/poc-onboarding.mdx
index a2e5ae4f5..4c454ee5c 100644
--- a/es/poc-onboarding.mdx
+++ b/es/poc-onboarding.mdx
@@ -25,8 +25,7 @@ Completa estos pasos en orden:
| 4. Publica un cambio | Verifica tu flujo de trabajo de redacción y revisión. |
| 5. Aplica tu marca | Alinea el sitio con tu producto. |
| 6. Prueba las funciones de IA | Evalúa las respuestas del asistente y un flujo de trabajo de IA. |
-| 7. Revisa los requisitos de TI y seguridad | Confirma los requisitos de autenticación y cumplimiento. |
-| 8. Revisa los resultados | Compara la POC con tus criterios de éxito. |
+| 7. Revisa los resultados | Compara la POC con tus criterios de éxito. |
Tu repositorio sigue siendo la fuente de la verdad. El dashboard te permite editar, configurar y publicar los archivos `.mdx` y la configuración `docs.json` de ese repositorio. Tu sitio en vivo muestra el resultado publicado.
@@ -43,7 +42,7 @@ Tu repositorio sigue siendo la fuente de la verdad. El dashboard te permite edit
| Responsable de la documentación | Dirige la POC y completa la mayoría de los pasos. | Unas pocas horas en total |
| Administrador de GitHub | Aprueba la aplicación de GitHub de Mintlify. | 15 minutos |
| Diseñador o responsable de marca | Proporciona logotipos, colores y fuentes. | 30 minutos |
-| Administrador de identidad o TI | Configura la autenticación y el DNS, si es necesario. | 1 a 2 horas |
+| Administrador de identidad o TI | Configura el DNS para un dominio personalizado, si pruebas la autenticación. | 1 a 2 horas |
- ## 获取帮助
-
-
-- 对于时间紧迫的 POC 问题，请使用你的共享 Slack 频道。
-- 其他问题请发送邮件至 [support@mintlify.com](mailto:support@mintlify.com)。
-- 有关 POC 之后的支持选项，请参阅[高级支持](/zh/advanced-support)。
-
## POC 之后
From 7887df50a51a6645efd149de278cddf1246b5d0e Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Tue, 25 Aug 2026 19:52:35 +0000
Subject: [PATCH 5/8] docs: sync with main, restore Get help heading, drop
stale step reference
---
agent/use-cases.mdx | 2 +-
assistant/index.mdx | 2 +-
changelog.mdx | 8 ++--
cli/commands.mdx | 4 ++
cli/index.mdx | 3 ++
components/update.mdx | 2 +-
deploy/rollbacks.mdx | 4 +-
editor/agent.mdx | 4 +-
editor/comments.mdx | 14 ++++++
editor/settings.mdx | 2 +-
es/cli/commands.mdx | 4 ++
es/cli/index.mdx | 6 +++
es/create/list-table.mdx | 16 +++++++
es/customize/custom-scripts.mdx | 9 +++-
es/editor/agent.mdx | 4 +-
es/editor/comments.mdx | 16 +++++++
es/quickstart.mdx | 4 +-
es/search-index/mcp.mdx | 2 +-
fr/cli/commands.mdx | 4 ++
fr/cli/index.mdx | 6 +++
fr/create/list-table.mdx | 16 +++++++
fr/customize/custom-scripts.mdx | 9 +++-
fr/editor/agent.mdx | 4 +-
fr/editor/comments.mdx | 16 +++++++
fr/quickstart.mdx | 4 +-
fr/search-index/mcp.mdx | 2 +-
migration/fern.mdx | 2 +-
optimize/seo.mdx | 2 +-
poc-onboarding.mdx | 68 ++++++------------------------
quickstart.mdx | 4 +-
search-index/mcp.mdx | 2 +-
snippets/es/setup-agent-prompt.mdx | 4 +-
snippets/fr/setup-agent-prompt.mdx | 4 +-
snippets/icons-optional.mdx | 8 ++--
snippets/zh/setup-agent-prompt.mdx | 4 +-
zh/cli/commands.mdx | 4 ++
zh/cli/index.mdx | 6 +++
zh/create/list-table.mdx | 16 +++++++
zh/customize/custom-scripts.mdx | 9 +++-
zh/editor/agent.mdx | 4 +-
zh/editor/comments.mdx | 16 +++++++
zh/quickstart.mdx | 4 +-
zh/search-index/mcp.mdx | 2 +-
43 files changed, 234 insertions(+), 92 deletions(-)
diff --git a/agent/use-cases.mdx b/agent/use-cases.mdx
index 9e5c41292..66e510f84 100644
--- a/agent/use-cases.mdx
+++ b/agent/use-cases.mdx
@@ -17,7 +17,7 @@ For example: `@mintlify Our quickstart page needs a new section on inviting coll
Prompt the agent to begin a project, then check out the branch it creates and finish the task in your local environment or the web editor. The agent can help you get started, then you can take over to complete the task.
-For example: `@mintlify Update the quickstart page to include information about inviting collaborators` and then checkout the branch to make any additional changes using your preferred method.
+For example: `@mintlify Update the quickstart page to include information about inviting collaborators` and then check out the branch to make any additional changes using your preferred method.
## Update docs when merging feature changes
diff --git a/assistant/index.mdx b/assistant/index.mdx
index b2fc3db6c..a9df441a7 100644
--- a/assistant/index.mdx
+++ b/assistant/index.mdx
@@ -32,7 +32,7 @@ By default, the assistant does not index hidden pages. To include hidden pages i
The assistant only answers questions based on information in your documentation. If it cannot find relevant information after searching, it responds that it doesn't have enough information to answer.
-You can [set a deflection email](/assistant/configure#set-deflection-email) so that the assistant provides your support email to users whose questions it cannot answer. This gives users a path forward, even if the documentation doesn't address their specific question.
+You can [set a deflection email](/assistant/configure#set-deflection-emails) so that the assistant provides your support email to users whose questions it cannot answer. This gives users a path forward, even if the documentation doesn't address their specific question.
## Assistant insights
diff --git a/changelog.mdx b/changelog.mdx
index bed561ed2..25f7d0da3 100644
--- a/changelog.mdx
+++ b/changelog.mdx
@@ -199,7 +199,7 @@ noindex: true
## Editor and collaboration
- **Review flow:** Request review on a draft, leave feedback, and approve or request changes before publishing. Reviews now support non-deploy branches.
- - **More ways to collaborate:** Start [comment threads](/editor/comments) on an entire page, mention yourself to leave a reminder, and use keybaord shortcuts Option + C or Option + S to comment on or suggest changes to selected text.
+ - **More ways to collaborate:** Start [comment threads](/editor/comments) on an entire page, mention yourself to leave a reminder, and use keyboard shortcuts Option + C or Option + S to comment on or suggest changes to selected text.
- **Faster, more available editing:** The editor renders without waiting for the Git file tree and people without GitHub write access can use the editor.
## Automations, integrations, and Slack
@@ -2143,7 +2143,7 @@ noindex: true
- Automatically generate an RSS feed from changelog pages
- Integrate RSS-enabled updates with Slack, email, and other tools
- Learn more in our new [Changelog guide](/create/changelogs)
+ Learn more in our new [Changelog guide](/create/changelogs).
+ ### Consulta las analíticas
+
+
+Ejecuta `mint analytics` para consultar estadísticas, búsquedas, feedback y conversaciones del asistente desde la terminal. La salida usa JSON por defecto cuando la CLI detecta un entorno de IA o de CI, para que los agentes puedan canalizar los resultados a otras herramientas.
+
### Gestiona la configuración
diff --git a/es/create/list-table.mdx b/es/create/list-table.mdx
index 31e5d5c9b..5e9eddb45 100644
--- a/es/create/list-table.mdx
+++ b/es/create/list-table.mdx
@@ -92,6 +92,22 @@ Para añadir una tabla, usa tres o más guiones (`---`) para crear el encabezado
```
+
+ ### Escapar caracteres de barra vertical
+
+
+Para incluir un carácter de barra vertical literal (`|`) en una celda de tabla, antepón una barra invertida (`\|`). Escapa los caracteres de barra vertical incluso cuando aparezcan dentro de código en línea. De lo contrario, la barra vertical se interpreta como un separador de columnas y puede causar errores de análisis durante la vista previa o la validación.
+
+| Valor | Descripción |
+| ------------- | ----------------------------------------------- |
+| `read\|write` | Un valor que contiene una barra vertical literal |
+
+```mdx
+| Value | Description |
+| ------------- | --------------------------------- |
+| `read\|write` | A value containing a literal pipe |
+```
+
### Alineación de columnas
diff --git a/es/customize/custom-scripts.mdx b/es/customize/custom-scripts.mdx
index 4639a0ee1..3dcabe614 100644
--- a/es/customize/custom-scripts.mdx
+++ b/es/customize/custom-scripts.mdx
@@ -208,7 +208,14 @@ Pueden aparecer múltiples instancias de estos elementos en una página. Úsalos
- `breadcrumb-item`—Elemento individual de miga de pan.
diff --git a/es/editor/comments.mdx b/es/editor/comments.mdx
index a28f6b4fd..6227c572b 100644
--- a/es/editor/comments.mdx
+++ b/es/editor/comments.mdx
@@ -62,6 +62,22 @@ Escribe `@` en un comentario o respuesta para mencionar a un compañero. Las per
Los compañeros mencionados reciben una notificación por correo electrónico.
+
+ ## Preguntar al agente de Mintlify
+
+
+Menciona `@mintlify` en un comentario, [sugerencia](/es/editor/suggestions) o respuesta para hacerle una pregunta al [agente del editor](/es/editor/agent) sobre la página actual. El agente se ejecuta de forma asíncrona con la página, el hilo y la branch como contexto, y luego publica su respuesta como una nueva respuesta en el mismo hilo.
+
+Usa las menciones `@mintlify` para hacer preguntas como:
+
+- `@mintlify does this endpoint support pagination?`
+- `@mintlify is this the recommended way to configure webhooks?`
+- `@mintlify are there any pages that contradict this?`
+
+El agente se ejecuta en modo de solo lectura cuando responde a comentarios. Puede buscar en tu documentación, leer páginas, obtener contenido web y cargar skills, pero no puede editar contenido, crear sugerencias ni publicar cambios. Para hacer cambios, abre el [agente del editor](/es/editor/agent) directamente.
+
+Las menciones `@mintlify` funcionan en páginas privadas para los miembros que ya tienen acceso. Cada respuesta del agente cuenta para tu uso del agente del editor.
+
## Resolver un comentario
diff --git a/es/quickstart.mdx b/es/quickstart.mdx
index 2aca780bf..fa98d5ee8 100644
--- a/es/quickstart.mdx
+++ b/es/quickstart.mdx
@@ -65,7 +65,9 @@ Cuando conectas tu repositorio de documentación a tu proyecto, puedes trabajar
+ ### Interrogez les analytics
+
+
+Exécutez `mint analytics` pour consulter les statistiques, les recherches, les retours et les conversations de l'assistant depuis le terminal. Par défaut, la sortie est au format JSON lorsque la CLI détecte un environnement d'IA ou de CI, afin que les agents puissent transmettre les résultats à d'autres outils.
+
### Gérez la configuration
diff --git a/fr/create/list-table.mdx b/fr/create/list-table.mdx
index 6aabb01af..0b99b033e 100644
--- a/fr/create/list-table.mdx
+++ b/fr/create/list-table.mdx
@@ -92,6 +92,22 @@ Pour ajouter un tableau, utilisez trois tirets ou plus (`---`) pour créer l’e
```
+
+ ### Échapper les caractères barre verticale
+
+
+Pour inclure un caractère barre verticale littéral (`|`) dans une cellule de tableau, faites-le précéder d'une barre oblique inverse (`\|`). Échappez les caractères barre verticale même lorsqu'ils apparaissent dans du code en ligne. Sinon, la barre verticale est interprétée comme un séparateur de colonnes et peut provoquer des erreurs d'analyse lors de la prévisualisation ou de la validation.
+
+| Valeur | Description |
+| ------------- | ------------------------------------------------------ |
+| `read\|write` | Une valeur contenant une barre verticale littérale |
+
+```mdx
+| Value | Description |
+| ------------- | --------------------------------- |
+| `read\|write` | A value containing a literal pipe |
+```
+
### Alignement des colonnes
diff --git a/fr/customize/custom-scripts.mdx b/fr/customize/custom-scripts.mdx
index aacd79a6b..a0ea1393a 100644
--- a/fr/customize/custom-scripts.mdx
+++ b/fr/customize/custom-scripts.mdx
@@ -208,7 +208,14 @@ Plusieurs instances de ces éléments peuvent apparaître sur une page. Utilisez
- `breadcrumb-item`—Élément individuel du fil d'Ariane.
diff --git a/fr/editor/comments.mdx b/fr/editor/comments.mdx
index fe2da9c16..fea32cf3c 100644
--- a/fr/editor/comments.mdx
+++ b/fr/editor/comments.mdx
@@ -62,6 +62,22 @@ Tapez `@` dans un commentaire ou une réponse pour mentionner un coéquipier. Le
Les coéquipiers mentionnés reçoivent une notification par e-mail.
+
+ ## Demander à l'agent Mintlify
+
+
+Mentionnez `@mintlify` dans un commentaire, une [suggestion](/fr/editor/suggestions) ou une réponse pour poser une question à l'[agent de l'éditeur](/fr/editor/agent) à propos de la page actuelle. L'agent s'exécute de manière asynchrone avec la page, le fil et la branche comme contexte, puis publie sa réponse en tant que nouvelle réponse dans le même fil.
+
+Utilisez les mentions `@mintlify` pour poser des questions telles que :
+
+- `@mintlify does this endpoint support pagination?`
+- `@mintlify is this the recommended way to configure webhooks?`
+- `@mintlify are there any pages that contradict this?`
+
+L'agent s'exécute en mode lecture seule lorsqu'il répond aux commentaires. Il peut effectuer une recherche dans votre documentation, lire des pages, récupérer du contenu web et charger des skills, mais il ne peut pas modifier le contenu, créer des suggestions ni publier de changements. Pour effectuer des modifications, ouvrez directement l'[agent de l'éditeur](/fr/editor/agent).
+
+Les mentions `@mintlify` fonctionnent sur les pages privées pour les membres qui y ont déjà accès. Chaque réponse de l'agent est comptabilisée dans votre utilisation de l'agent de l'éditeur.
+
## Résoudre un commentaire
diff --git a/fr/quickstart.mdx b/fr/quickstart.mdx
index abf1d52cb..85462876a 100644
--- a/fr/quickstart.mdx
+++ b/fr/quickstart.mdx
@@ -65,7 +65,9 @@ Lorsque vous connectez votre référentiel de documentation à votre projet, vou
+ ### 查询分析数据
+
+
+运行 `mint analytics` 从终端查看文档统计、搜索、反馈和助手会话。当 CLI 检测到 AI 或 CI 环境时，输出默认使用 JSON，方便 agent 将结果传给其他工具。
+
### 管理配置
diff --git a/zh/create/list-table.mdx b/zh/create/list-table.mdx
index e009416c5..aa712cf2c 100644
--- a/zh/create/list-table.mdx
+++ b/zh/create/list-table.mdx
@@ -92,6 +92,22 @@ keywords: ["有序列表", "无序列表", "Markdown 表格", "表格格式"]
```
+
+ ### 转义竖线字符
+
+
+要在表格单元格中包含字面量竖线字符（`|`），请在其前面加上反斜杠（`\|`）。即使竖线字符出现在行内代码中，也需要转义。否则，竖线会被视为列分隔符，可能在预览或验证时导致解析错误。
+
+| 值 | 说明 |
+| ------------- | ------------------------ |
+| `read\|write` | 包含字面量竖线的值 |
+
+```mdx
+| Value | Description |
+| ------------- | --------------------------------- |
+| `read\|write` | A value containing a literal pipe |
+```
+
### 列对齐
diff --git a/zh/customize/custom-scripts.mdx b/zh/customize/custom-scripts.mdx
index 64d0918ed..22622f4f9 100644
--- a/zh/customize/custom-scripts.mdx
+++ b/zh/customize/custom-scripts.mdx
@@ -208,7 +208,14 @@ Mintlify 提供两种类型的 CSS 定位钩子：
- `breadcrumb-item`—单个面包屑项。
## 将选中内容添加到代理
diff --git a/zh/editor/comments.mdx b/zh/editor/comments.mdx
index c95961376..b211d19d2 100644
--- a/zh/editor/comments.mdx
+++ b/zh/editor/comments.mdx
@@ -62,6 +62,22 @@ keywords: ["editor", "评论", "协作", "反馈", "提及", "讨论线程"]
被提及的团队成员会收到电子邮件通知。
+
+ ## 向 Mintlify 智能体提问
+
+
+在评论、[建议](/zh/editor/suggestions)或回复中提及 `@mintlify`，即可就当前页面向[编辑器代理](/zh/editor/agent)提问。智能体会以该页面、讨论线程和分支作为上下文异步运行，然后将答复作为新的回复发布到同一线程中。
+
+使用 `@mintlify` 提及来提问，例如：
+
+- `@mintlify does this endpoint support pagination?`
+- `@mintlify is this the recommended way to configure webhooks?`
+- `@mintlify are there any pages that contradict this?`
+
+在回复评论时，智能体以只读模式运行。它可以搜索你的文档、阅读页面、获取网页内容以及加载 skills，但无法编辑内容、创建建议或发布更改。要进行更改，请直接打开[编辑器代理](/zh/editor/agent)。
+
+对于已拥有访问权限的成员，`@mintlify` 提及在私有页面上同样有效。每次智能体回复都会计入你的编辑器代理用量。
+
## 解决评论
diff --git a/zh/quickstart.mdx b/zh/quickstart.mdx
index d413a8155..6b68a1039 100644
--- a/zh/quickstart.mdx
+++ b/zh/quickstart.mdx
@@ -65,7 +65,9 @@ Mintlify 使用“文档即代码”（docs-as-code）的方法来管理你的
### Reúne tu contenido y tus recursos de marca
@@ -115,7 +114,7 @@ Comparte el objetivo, la línea base y los criterios con tu AE o SE.
-Usa la URL `.mintlify.site` durante la POC, a menos que necesites probar la autenticación. La autenticación requiere un dominio personalizado o un subdominio `*.mintlify.app`.
+Usa la URL `.mintlify.site` durante la POC, a menos que necesites probar la autenticación. La autenticación requiere un [dominio personalizado](/es/customize/custom-domain) o un subdominio `*.mintlify.app`, y no funciona en un basepath personalizado como `yourcompany.com/docs`.
## Paso 2: Invita a tu equipo
@@ -316,64 +315,8 @@ Elige el flujo de trabajo más relevante para tu evaluación:
-
- La autenticación del sitio no funciona en la URL predeterminada `.mintlify.site` ni en un basepath personalizado como `yourcompany.com/docs`. Usa un dominio personalizado o un subdominio `*.mintlify.app`.
-
-
-
- `hidden: true` elimina una página de la navegación pero no restringe el acceso. Usa la autenticación y los grupos para el control de acceso. Consulta [Páginas ocultas](/es/organize/hidden-pages).
-
-
-
- ## Paso 7: Revisa los requisitos de TI y seguridad
-
-
-Involucra a tu equipo de TI o seguridad en la POC antes de la revisión final.
-
-
- ### Controla el acceso al dashboard
-
-
-Evalúa los controles que tu equipo requiere:
-
-- [Inicio de sesión único](/es/dashboard/sso) con SAML u OIDC.
-- [Aprovisionamiento de SCIM](/es/dashboard/scim).
-- [Políticas de acceso a la red](/es/dashboard/network-access).
-- [Registros de auditoría](/es/dashboard/audit-logs) y [seguridad de sesiones](/es/dashboard/session-security).
-
-
- ### Controla el acceso a la documentación
-
-
-Configura la [autenticación](/es/deploy/authentication-setup) para tus lectores:
-
-- **Contraseña:** Control de acceso rápido para una POC.
-- **Acceso administrado por Mintlify:** Usa tu organización del dashboard como lista de usuarios.
-- **OAuth 2.0:** Se conecta a tu proveedor de identidad.
-- **JWT:** Admite modelos de acceso programático personalizados.
-
-Usa [grupos](/es/deploy/authentication-setup#control-access-with-groups) para restringir páginas específicas:
-
-```yaml
----
-title: "Production runbook"
-groups: ["engineering"]
----
-```
-
-Haz la prueba con una cuenta dentro del grupo y otra cuenta fuera de él.
-
-
- ### Completa las verificaciones de infraestructura y cumplimiento
-
-
-- Agrega un [dominio personalizado](/es/customize/custom-domain). Usa un subdominio de prueba durante la POC.
-- Conecta tu [plataforma de analíticas](/es/integrations/analytics/overview).
-- Habilita las [comprobaciones de CI](/es/deploy/ci) para enlaces y accesibilidad.
-- Comparte [Contratación empresarial](/es/enterprise-contracting) con los equipos de seguridad y compras.
-
-
- ## Paso 8: Revisa los resultados
+
+ ## Paso 7: Revisa los resultados
Reserva una hora con tu responsable de la decisión. Comienza con el objetivo y la línea base que definiste antes de la POC y luego revisa:
@@ -387,7 +330,6 @@ Reserva una hora con tu responsable de la decisión. Comienza con el objetivo y
| Las brechas de contenido son identificables | Preguntas sin respuesta y con voto negativo en las [analíticas del asistente](/es/analytics/assistant). |
| Los lectores encuentran contenido útil | Datos de [tráfico](/es/analytics/traffic), [búsqueda](/es/analytics/search) e [interacción](/es/analytics/user-engagements). |
| Las actualizaciones automatizadas son útiles | El historial de ejecuciones de la automatización y el cambio propuesto. |
-| Se cumplen los requisitos de seguridad | La revisión de tu equipo de TI. |
Resuelve las preguntas pendientes con tu AE o SE antes de esta reunión.
@@ -401,7 +343,15 @@ La mayoría de las POC toman dos a tres semanas:
|---|---|
| Semana 1 | Conecta el repositorio, invita a tu equipo, define el éxito y comienza la migración del contenido. Inicia la configuración del dominio si necesitas autenticación. |
| Semana 2 | Revisa el contenido, publica un cambio, aplica tu marca, prueba el asistente y evalúa un flujo de trabajo de IA. |
-| Semana 3 | Completa la revisión de TI y seguridad y luego revisa los resultados con tu responsable de la decisión. |
+| Semana 3 | Revisa los resultados con tu responsable de la decisión. |
+
+
+ ## Obtener ayuda
+
+
+- Contacta a tu AE o SE para preguntas urgentes sobre la POC.
+- Escribe a [support@mintlify.com](mailto:support@mintlify.com) para otras preguntas.
+- Consulta [Soporte avanzado](/es/advanced-support) para ver las opciones de soporte después de la POC.
## Después de la POC
diff --git a/fr/poc-onboarding.mdx b/fr/poc-onboarding.mdx
index 342c1338e..c252df714 100644
--- a/fr/poc-onboarding.mdx
+++ b/fr/poc-onboarding.mdx
@@ -25,8 +25,7 @@ Effectuez ces étapes dans l'ordre :
| 4. Publier une modification | Vérifier votre workflow de rédaction et de revue. |
| 5. Appliquer votre image de marque | Aligner le site sur votre produit. |
| 6. Tester les fonctionnalités d'IA | Évaluer les réponses de l'assistant et un workflow d'IA. |
-| 7. Passer en revue les exigences IT et de sécurité | Confirmer les exigences d'authentification et de conformité. |
-| 8. Passer en revue les résultats | Comparer le POC à vos critères de réussite. |
+| 7. Passer en revue les résultats | Comparer le POC à vos critères de réussite. |
Votre dépôt reste la source de vérité. Le tableau de bord vous permet de modifier, configurer et publier les fichiers `.mdx` et la configuration `docs.json` de ce dépôt. Votre site en ligne affiche le résultat publié.
@@ -43,7 +42,7 @@ Votre dépôt reste la source de vérité. Le tableau de bord vous permet de mod
| Responsable de la documentation | Pilote le POC et réalise la plupart des étapes. | Quelques heures au total |
| Administrateur GitHub | Approuve la GitHub App Mintlify. | 15 minutes |
| Designer ou responsable de la marque | Fournit les logos, les couleurs et les polices. | 30 minutes |
-| Administrateur des identités ou IT | Configure l'authentification et le DNS, si nécessaire. | 1 à 2 heures |
+| Administrateur des identités ou IT | Configure le DNS pour un domaine personnalisé, si vous testez l'authentification. | 1 à 2 heures |
### Rassembler votre contenu et vos éléments de marque
@@ -115,7 +114,7 @@ Partagez l'objectif, la valeur de référence et les critères avec votre AE ou
-Utilisez l'URL `.mintlify.site` pendant le POC, sauf si vous devez tester l'authentification. L'authentification nécessite un domaine personnalisé ou un sous-domaine `*.mintlify.app`.
+Utilisez l'URL `.mintlify.site` pendant le POC, sauf si vous devez tester l'authentification. L'authentification nécessite un [domaine personnalisé](/fr/customize/custom-domain) ou un sous-domaine `*.mintlify.app`, et ne fonctionne pas sur un basepath personnalisé tel que `yourcompany.com/docs`.
## Étape 2 : inviter votre équipe
@@ -316,64 +315,8 @@ Choisissez le workflow le plus pertinent pour votre évaluation :
-
- L'authentification du site ne fonctionne pas sur l'URL `.mintlify.site` par défaut ni sur un basepath personnalisé tel que `yourcompany.com/docs`. Utilisez un domaine personnalisé ou un sous-domaine `*.mintlify.app`.
-
-
-
- `hidden: true` retire une page de la navigation mais n'en restreint pas l'accès. Utilisez l'authentification et les groupes pour le contrôle d'accès. Consultez [Pages masquées](/fr/organize/hidden-pages).
-
-
-
- ## Étape 7 : passer en revue les exigences IT et de sécurité
-
-
-Impliquez votre équipe IT ou sécurité dans le POC avant la revue finale.
-
-
- ### Contrôler l'accès au tableau de bord
-
-
-Évaluez les contrôles requis par votre équipe :
-
-- L'[authentification unique](/fr/dashboard/sso) avec SAML ou OIDC.
-- Le [provisionnement SCIM](/fr/dashboard/scim).
-- Les [politiques d'accès réseau](/fr/dashboard/network-access).
-- Les [journaux d'audit](/fr/dashboard/audit-logs) et la [sécurité des sessions](/fr/dashboard/session-security).
-
-
- ### Contrôler l'accès à la documentation
-
-
-Configurez l'[authentification](/fr/deploy/authentication-setup) pour vos lecteurs :
-
-- **Mot de passe :** contrôle d'accès rapide pour un POC.
-- **Accès géré par Mintlify :** utilise l'organisation de votre tableau de bord comme liste d'utilisateurs.
-- **OAuth 2.0 :** se connecte à votre fournisseur d'identité.
-- **JWT :** prend en charge des modèles d'accès programmatiques personnalisés.
-
-Utilisez les [groupes](/fr/deploy/authentication-setup#control-access-with-groups) pour restreindre certaines pages :
-
-```yaml
----
-title: "Production runbook"
-groups: ["engineering"]
----
-```
-
-Testez avec un compte appartenant au groupe et un compte en dehors du groupe.
-
-
- ### Effectuer les vérifications d'infrastructure et de conformité
-
-
-- Ajoutez un [domaine personnalisé](/fr/customize/custom-domain). Utilisez un sous-domaine de test pendant le POC.
-- Connectez votre [plateforme d'analyse](/fr/integrations/analytics/overview).
-- Activez les [vérifications CI](/fr/deploy/ci) pour les liens et l'accessibilité.
-- Partagez [Contrats entreprise](/fr/enterprise-contracting) avec les équipes sécurité et achats.
-
-
- ## Étape 8 : passer en revue les résultats
+
+ ## Étape 7 : passer en revue les résultats
Réservez une heure avec votre décideur. Commencez par l'objectif et la valeur de référence définis avant le POC, puis passez en revue :
@@ -387,7 +330,6 @@ Réservez une heure avec votre décideur. Commencez par l'objectif et la valeur
| Les lacunes de contenu sont identifiables | Les questions sans réponse et avec vote négatif dans les [analyses de l'assistant](/fr/analytics/assistant). |
| Les lecteurs trouvent du contenu utile | Les données de [trafic](/fr/analytics/traffic), de [recherche](/fr/analytics/search) et d'[engagement](/fr/analytics/user-engagements). |
| Les mises à jour automatisées sont utiles | L'historique des exécutions de l'automatisation et la modification proposée. |
-| Les exigences de sécurité sont satisfaites | La revue de votre équipe IT. |
Résolvez les questions en suspens avec votre AE ou SE avant cette réunion.
@@ -401,7 +343,15 @@ La plupart des POC durent deux à trois semaines :
|---|---|
| Semaine 1 | Connecter le dépôt, inviter votre équipe, définir la réussite et démarrer la migration du contenu. Commencer la configuration du domaine si vous avez besoin de l'authentification. |
| Semaine 2 | Vérifier le contenu, publier une modification, appliquer l'image de marque, tester l'assistant et évaluer un workflow d'IA. |
-| Semaine 3 | Terminer la revue IT et sécurité, puis passer en revue les résultats avec votre décideur. |
+| Semaine 3 | Passer en revue les résultats avec votre décideur. |
+
+
+ ## Obtenir de l'aide
+
+
+- Contactez votre AE ou SE pour les questions urgentes liées au POC.
+- Écrivez à [support@mintlify.com](mailto:support@mintlify.com) pour toute autre question.
+- Consultez [Support avancé](/fr/advanced-support) pour les options de support après le POC.
## Après le POC
diff --git a/zh/poc-onboarding.mdx b/zh/poc-onboarding.mdx
index f2d974ea0..c5947cf8e 100644
--- a/zh/poc-onboarding.mdx
+++ b/zh/poc-onboarding.mdx
@@ -25,8 +25,7 @@ noindex: true
| 4. 发布一次更改 | 验证你的写作和审查工作流。 |
| 5. 应用品牌样式 | 让站点与你的产品保持一致。 |
| 6. 测试 AI 功能 | 评估助手的回答和一个 AI 工作流。 |
-| 7. 审查 IT 和安全要求 | 确认身份验证和合规要求。 |
-| 8. 审查结果 | 将 POC 与你的成功标准进行对比。 |
+| 7. 审查结果 | 将 POC 与你的成功标准进行对比。 |
你的仓库始终是唯一数据源。控制面板让你可以编辑、配置和发布该仓库中的 `.mdx` 文件和 `docs.json` 配置。你的线上站点展示发布后的结果。
@@ -43,7 +42,7 @@ noindex: true
| 文档负责人 | 主导 POC 并完成大部分步骤。 | 总计几个小时 |
| GitHub 管理员 | 批准 Mintlify GitHub 应用。 | 15 分钟 |
| 设计师或品牌负责人 | 提供徽标、颜色和字体。 | 30 分钟 |
-| 身份或 IT 管理员 | 配置身份验证和 DNS（如需要）。 | 1 到 2 小时 |
+| 身份或 IT 管理员 | 如果你要测试身份验证，为自定义域名配置 DNS。 | 1 到 2 小时 |
### 收集你的内容和品牌资产
@@ -115,7 +114,7 @@ noindex: true
-除非你需要测试身份验证，否则在 POC 期间请使用 `.mintlify.site` URL。身份验证需要自定义域名或 `*.mintlify.app` 子域名。
+除非你需要测试身份验证，否则在 POC 期间请使用 `.mintlify.site` URL。身份验证需要[自定义域名](/zh/customize/custom-domain)或 `*.mintlify.app` 子域名，并且在自定义基础路径（例如 `yourcompany.com/docs`）上不起作用。
## 第 2 步：邀请你的团队
@@ -316,64 +315,8 @@ noindex: true
-
- 站点身份验证在默认的 `.mintlify.site` URL 或自定义基础路径（例如 `yourcompany.com/docs`）上不起作用。请使用自定义域名或 `*.mintlify.app` 子域名。
-
-
-
- `hidden: true` 会将页面从导航中移除，但不会限制访问。请使用身份验证和群组进行访问控制。请参阅[隐藏页面](/zh/organize/hidden-pages)。
-
-
-
- ## 第 7 步：审查 IT 和安全要求
-
-
-在最终审查之前，让你的 IT 或安全团队参与到 POC 中。
-
-
- ### 控制控制面板访问权限
-
-
-评估你的团队所需的控制措施：
-
-- 使用 SAML 或 OIDC 的[单点登录](/zh/dashboard/sso)。
-- [SCIM 配置](/zh/dashboard/scim)。
-- [网络访问策略](/zh/dashboard/network-access)。
-- [审计日志](/zh/dashboard/audit-logs)和[会话安全](/zh/dashboard/session-security)。
-
-
- ### 控制文档访问权限
-
-
-为你的读者配置[身份验证](/zh/deploy/authentication-setup)：
-
-- **密码：** 适用于 POC 的快速访问控制。
-- **Mintlify 托管访问：** 使用你的控制面板组织作为用户列表。
-- **OAuth 2.0：** 连接到你的身份提供商。
-- **JWT：** 支持自定义的程序化访问模型。
-
-使用[群组](/zh/deploy/authentication-setup#control-access-with-groups)限制特定页面：
-
-```yaml
----
-title: "Production runbook"
-groups: ["engineering"]
----
-```
-
-分别使用一个属于该群组的账号和一个不属于该群组的账号进行测试。
-
-
- ### 完成基础设施和合规检查
-
-
-- 添加[自定义域名](/zh/customize/custom-domain)。在 POC 期间使用测试子域名。
-- 连接你的[分析平台](/zh/integrations/analytics/overview)。
-- 为链接和可访问性启用 [CI 检查](/zh/deploy/ci)。
-- 与安全和采购团队分享[企业合同](/zh/enterprise-contracting)。
-
-
- ## 第 8 步：审查结果
+
+ ## 第 7 步：审查结果
与决策者预约一小时的会议。从 POC 前定义的目标和基线开始，然后审查：
@@ -387,7 +330,6 @@ groups: ["engineering"]
| 可以识别内容缺口 | [助手分析](/zh/analytics/assistant)中未回答和被点踩的问题。 |
| 读者能找到有用的内容 | [流量](/zh/analytics/traffic)、[搜索](/zh/analytics/search)和[用户参与](/zh/analytics/user-engagements)数据。 |
| 自动更新有价值 | 自动化的运行历史和提出的更改。 |
-| 满足安全要求 | 你的 IT 团队的审查结果。 |
在此会议之前，与你的 AE 或 SE 解决所有未决问题。
@@ -401,7 +343,15 @@ groups: ["engineering"]
|---|---|
| 第 1 周 | 连接仓库、邀请团队、定义成功标准并开始内容迁移。如果需要身份验证，开始域名设置。 |
| 第 2 周 | 审查内容、发布一次更改、应用品牌样式、测试助手并评估一个 AI 工作流。 |
-| 第 3 周 | 完成 IT 和安全审查，然后与决策者一起审查结果。 |
+| 第 3 周 | 与决策者一起审查结果。 |
+
+
+ ## 获取帮助
+
+
+- 如有紧急的 POC 问题，请联系你的 AE 或 SE。
+- 其他问题请发送邮件至 [support@mintlify.com](mailto:support@mintlify.com)。
+- POC 之后的支持选项请参阅[高级支持](/zh/advanced-support)。
## POC 之后
From 53f082228869beb3d65cc1d27fe0a7e920a79fa4 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Tue, 25 Aug 2026 22:16:53 +0000
Subject: [PATCH 7/8] docs: fix MDX extension nav path and unify UI verbs on
new page
---
.../config/vocabularies/Mintlify/accept.txt | 2 +-
ai/llmstxt.mdx | 14 +-
ai/mintlify-mcp.mdx | 13 ++
cli/index.mdx | 1 +
cli/install.mdx | 10 +-
cli/mdx-extension.mdx | 143 ++++++++++++++++++
cli/preview.mdx | 4 +
docs.json | 1 +
es/ai/llmstxt.mdx | 33 +++-
es/ai/mintlify-mcp.mdx | 15 ++
es/deploy/reverse-proxy.mdx | 21 +++
fr/ai/llmstxt.mdx | 33 +++-
fr/ai/mintlify-mcp.mdx | 15 ++
fr/deploy/reverse-proxy.mdx | 21 +++
poc-onboarding.mdx | 2 +-
zh/ai/llmstxt.mdx | 33 +++-
zh/ai/mintlify-mcp.mdx | 15 ++
zh/deploy/reverse-proxy.mdx | 21 +++
18 files changed, 375 insertions(+), 22 deletions(-)
create mode 100644 cli/mdx-extension.mdx
diff --git a/.vale/styles/config/vocabularies/Mintlify/accept.txt b/.vale/styles/config/vocabularies/Mintlify/accept.txt
index 575cedf8b..ed010ced0 100644
--- a/.vale/styles/config/vocabularies/Mintlify/accept.txt
+++ b/.vale/styles/config/vocabularies/Mintlify/accept.txt
@@ -346,7 +346,7 @@ PostgreSQL
Postman
PowerShell
PR
-prefetching
+(?i)prefetch(es|ed|ing)?
prefill(s|ing|ed)?
preloaded
prepend(ed|ing)?
diff --git a/ai/llmstxt.mdx b/ai/llmstxt.mdx
index c362042e1..dee993987 100644
--- a/ai/llmstxt.mdx
+++ b/ai/llmstxt.mdx
@@ -57,15 +57,21 @@ This structured approach allows LLMs to efficiently process your documentation a
## Split indexes under `/_llms`
-Automatically generated `llms.txt` index files cannot exceed 100,000 characters. When an index is larger than this limit, Mintlify keeps the main `llms.txt` file as a directory and moves groups of page links into generated Markdown files under `/_llms/`. This limit does not apply to `llms-full.txt`.
+Automatically generated `llms.txt` index files cannot exceed 100,000 characters. When an index is larger than this limit, Mintlify keeps the main `llms.txt` file as a directory and moves groups of page links into generated Markdown files under `/_llms/`. Every page stays discoverable: splitting never omits pages from the index. This limit does not apply to `llms-full.txt`.
-For example, a large site might link to the following generated index:
+Links to generated indexes appear in an `Indexes` section. Each link includes the group's breadcrumb, its page count, and a description:
```mdx
-- [API reference](https://docs.example.com/_llms/api-reference.md)
+> The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages.
+
+## Indexes
+
+- [API reference (250 pages)](https://docs.example.com/_llms/api-reference.md): Endpoint documentation for the example API
```
-Agents should follow these index links recursively until they reach documentation page links. The generated files are part of `llms.txt` and do not need to exist in your repository. They are separate from `llms-full.txt`.
+A generated index can link to further indexes. For example, `/_llms/api-reference.md` can link to `/_llms/api-reference/admin.md` when a group is too large for a single file. Agents should follow these index links recursively until they reach documentation page links. Mintlify may shorten page descriptions in a split index to keep each file under the character limit.
+
+The generated files are part of `llms.txt` and do not need to exist in your repository. They are separate from `llms-full.txt`.
The `/_llms/` route uses the same base path as your documentation:
diff --git a/ai/mintlify-mcp.mdx b/ai/mintlify-mcp.mdx
index fb2ed56c7..690b8ba26 100644
--- a/ai/mintlify-mcp.mdx
+++ b/ai/mintlify-mcp.mdx
@@ -132,6 +132,19 @@ Every admin MCP session binds to a single Git branch. The flow is:
Calling `checkout` again with a different `subdomain` or branch switches which session is active. It doesn't discard the others. To abandon an in-progress draft instead of switching away from it, call `discard_session`.
+## Publishing
+
+The **Publishing** section on the admin MCP settings page in your dashboard controls what happens when `save` runs with `mode: "auto"`. Toggle **Push directly to your deploy branch** on to have Mintlify push changes straight to your deploy branch. Toggle it off to have `save` open a pull request instead.
+
+This toggle shares the same `agentReviewProcess` setting as the Slack and dashboard agent, so any change here also applies to those flows.
+
+The toggle is disabled in two cases:
+
+- **Your deploy branch requires a pull request.** If branch protection rules or required approvals prevent direct pushes, MCP changes always open a pull request regardless of this setting.
+- **Mintlify hosts your deployment.** For Mintlify-hosted sites, MCP changes always push directly, unless branch protection still requires a pull request.
+
+You can also override the setting on a per-call basis by passing an explicit `mode` to `save`: `"pr"` always opens a pull request, and `"commit"` pushes to an existing PR branch without opening a new PR.
+
## What the admin MCP can do
### Content
diff --git a/cli/index.mdx b/cli/index.mdx
index 5f2eeeb91..ea54fbc3b 100644
--- a/cli/index.mdx
+++ b/cli/index.mdx
@@ -54,5 +54,6 @@ Run `mint config` to set persistent defaults like your documentation subdomain.
## Next steps
- [Install the CLI](/cli/install): Get the CLI installed and ready to use.
+- [Mintlify MDX extension](/cli/mdx-extension): Add autocomplete, inline error checking, and an in-editor preview.
- [Preview locally](/cli/preview): Run a local development server with search and assistant support.
- [Commands](/cli/commands): Complete reference for all commands and flags.
diff --git a/cli/install.mdx b/cli/install.mdx
index e8fbba5be..6dc89c4bd 100644
--- a/cli/install.mdx
+++ b/cli/install.mdx
@@ -113,12 +113,14 @@ If `mint update` is not available on your version, reinstall the CLI with the la
```
-## Formatting
+## Editor support
-For syntax highlighting and code formatting in MDX files, use the following extensions:
+For syntax highlighting, autocomplete, and error checking in MDX files, use the following extensions:
-- **Cursor, Devin Desktop, VS Code**: [MDX VS Code extension](https://marketplace.visualstudio.com/items?itemName=unifiedjs.vscode-mdx) and [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode)
-- **JetBrains**: [MDX IntelliJ IDEA plugin](https://plugins.jetbrains.com/plugin/14944-mdx) and [Prettier](https://prettier.io/docs/webstorm)
+- **Cursor, Devin Desktop, VS Code**: [Mintlify MDX extension](/cli/mdx-extension) and [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) for formatting.
+- **JetBrains**: [MDX IntelliJ IDEA plugin](https://plugins.jetbrains.com/plugin/14944-mdx) and [Prettier](https://prettier.io/docs/webstorm).
+
+You can also format MDX files with [`mint format`](/cli/commands#mint-format).
## Troubleshooting
diff --git a/cli/mdx-extension.mdx b/cli/mdx-extension.mdx
new file mode 100644
index 000000000..96a4f598d
--- /dev/null
+++ b/cli/mdx-extension.mdx
@@ -0,0 +1,143 @@
+---
+title: "Mintlify MDX extension"
+description: "Install the Mintlify MDX extension for autocomplete, inline diagnostics, hover documentation, and an in-editor preview while you write MDX locally."
+keywords: ["Cursor", "MDX", "autocomplete", "diagnostics", "IntelliSense", "preview", "editor"]
+---
+
+The Mintlify MDX extension adds language support for Mintlify projects to VS Code, Cursor, Devin Desktop, and other editors that support the VS Code extension API. The extension knows every built-in component and property, so you get autocomplete as you type, and it reports unknown components, invalid properties, and unresolved snippet imports.
+
+The extension also runs a live preview inside your editor, so you can write and see rendered output without switching to a browser.
+
+## Prerequisites
+
+- VS Code 1.85.0 or newer
+- A documentation directory with a valid `docs.json` file
+- The [Mintlify CLI](/cli/install), for the in-editor preview only
+
+## Install the extension
+
+Install from the command line:
+
+```bash
+code --install-extension mintlify.mintlify-snippets
+```
+
+Or install from within your editor:
+
+1. Open the Extensions view.
+2. Search for `@id:mintlify.mintlify-snippets`.
+3. Select **Install**.
+
+You can also install from the [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=mintlify.mintlify-snippets).
+
+The extension activates when you open an `.mdx` file or a workspace containing a `docs.json` file.
+
+## Autocomplete
+
+Type `<` to view every built-in component. Autocomplete suggests components' properties and values inside tags.
+
+The extension suggests components that you import from [reusable snippets](/create/reusable-snippets) alongside built-in ones.
+
+## Diagnostics
+
+The extension reports problems in the Problems panel and underlines them in your file as you write:
+
+- Unknown components.
+- Unknown or duplicate properties.
+- Invalid values for enumerated properties.
+- Missing required properties.
+- Unclosed or mismatched tags.
+- Unresolved snippet imports.
+
+These classes of error cause build failures, so fix them as you write to avoid failed deployments.
+
+To turn diagnostics off, set `mintlify.diagnostics.enabled` to `false`.
+
+## Hover documentation
+
+Hover over a component or property to see what it does and a link to its page in the Mintlify documentation. Hovering over a snippet component previews the contents of the snippet file.
+
+## Go to definition
+
+Hold CMD (macOS) or CTRL (Windows) and click to navigate to the definition of:
+
+- Snippet components.
+- Import paths.
+- `href` and `src` attributes that point to local pages.
+
+The extension finds your docs root by walking up from the open file until it finds `docs.json`, so absolute imports like `/snippets/example.mdx` resolve correctly. The detected project appears in the status bar. To check which root the extension is using, run **Mintlify: Show detected docs root** from the command palette.
+
+## Configuration validation
+
+The extension validates `docs.json` against the [Mintlify schema](https://mintlify.com/docs.json).
+
+## Preview in your editor
+
+Open an `.mdx` file and select the preview icon in the editor title bar, or right-click the file and select **Preview Mintlify**. A preview panel opens beside your editor and renders the page.
+
+In-editor previews require the [Mintlify CLI](/cli/install). The URL of the running server appears in the status bar. Select it to stop the server, or run **Mintlify: Stop preview server**.
+
+To see the output of the underlying `mint dev` process, open the **Mintlify Preview** output channel.
+
+
+ Use the in-editor preview while you write individual pages, and [`mint dev`](/cli/preview) in a browser when you want to test navigation, search, or authentication across your whole site.
+
+
+## Wrap content in components
+
+The extension includes snippets that wrap selected text in a component, rather than inserting an empty component for you to fill in.
+
+To use them, select the content you want to wrap, then run **Snippets: Surround With** from the command palette and select a component. Snippets are available for `AccordionGroup`, `CardGroup`, `CodeGroup`, `Expandable`, `Frame`, `RequestExample`, `ResponseExample`, and fenced code blocks.
+
+## Settings
+
+| Setting | Default | Description |
+| --- | --- | --- |
+| `mintlify.diagnostics.enabled` | `true` | Report unknown components, unknown properties, missing required properties, and unresolved snippet imports. |
+| `mintlify.warnAboutConflictingExtensions` | `true` | Warn when you have another MDX extension installed alongside the Mintlify MDX extension. |
+| `mintlify.preview.command` | `mint dev --no-open` | Command used to start the preview server, run from your project root. |
+| `mintlify.preview.followScroll` | `true` | Scroll the preview to the heading nearest the top of your editor. |
+
+`mintlify.preview.command` is a user setting, so a workspace cannot override it. This prevents a cloned repository from running an arbitrary command on your machine when you open a preview.
+
+## Commands
+
+Run these from the command palette:
+
+| Command | Description |
+| --- | --- |
+| **Mintlify: Preview Mintlify** | Open the preview panel for the current file. |
+| **Mintlify: Stop preview server** | Stop the running preview server. |
+| **Mintlify: Show detected docs root** | Show which `docs.json` file the extension resolved. |
+| **Mintlify: Open component docs** | Open the documentation for the component at your cursor. |
+| **Mintlify: Restart language server** | Restart the language server. |
+
+## Conflicting extensions
+
+Other MDX extensions provide their own syntax highlighting and language features for `.mdx` files, which conflict with this extension. Disable other MDX extensions to avoid duplicate suggestions and inconsistent highlighting.
+
+For code formatting, use [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) alongside this extension or run [`mint format`](/cli/commands#mint-format).
+
+## Troubleshooting
+
+
+
+ The extension resolves components relative to your docs root. Run **Mintlify: Show detected docs root** to confirm it found the correct `docs.json` file. If the root is wrong or missing, open the folder containing your `docs.json` file as your workspace.
+
+ If the root is correct, run **Mintlify: Restart language server**.
+
+
+ Another MDX extension is likely also active. Open the Extensions view, search for `mdx`, and disable any other MDX extensions in this workspace.
+
+
+ Open the **Mintlify Preview** output channel to see the error from `mint dev`.
+
+ - `could not run "mint dev --no-open"`: The CLI is not installed. Install it with `npm i -g mint`.
+ - `Trust the workspace first`: Trust the workspace through **Manage Workspace Trust**.
+ - `no docs.json found above this file`: Open the folder containing your `docs.json` file as your workspace.
+ - `Invalid docs.json`: Run [`mint validate`](/cli/commands#mint-validate) to find the configuration error.
+
+
+ Absolute import paths resolve from your docs root, not from your file. Confirm the path matches the location of the snippet file relative to your `docs.json` file, and that the detected root is correct.
+
+
diff --git a/cli/preview.mdx b/cli/preview.mdx
index a7263ca9d..c8bbadc04 100644
--- a/cli/preview.mdx
+++ b/cli/preview.mdx
@@ -31,6 +31,10 @@ To generate a preview without installing the CLI globally, run:
npx mint dev
```
+
+ If you write in VS Code or Cursor, the [Mintlify MDX extension](/cli/mdx-extension) runs this preview in a panel beside your editor and scrolls it to match the page you are editing.
+
+
## Log in for search and assistant
You must authenticate the CLI with your Mintlify account to enable search and the [assistant](/assistant/index).
diff --git a/docs.json b/docs.json
index c643ccf21..a917458ea 100644
--- a/docs.json
+++ b/docs.json
@@ -37,6 +37,7 @@
"root": "cli/index",
"pages": [
"cli/install",
+ "cli/mdx-extension",
"cli/preview",
"cli/commands"
]
diff --git a/es/ai/llmstxt.mdx b/es/ai/llmstxt.mdx
index c6ac44645..fb173516a 100644
--- a/es/ai/llmstxt.mdx
+++ b/es/ai/llmstxt.mdx
@@ -57,11 +57,36 @@ Tanto `llms.txt` como `llms-full.txt` listan las páginas de tu idioma predeterm
Este enfoque estructurado permite a los LLM procesar tu documentación de forma eficiente a un alto nivel y localizar contenido relevante para las consultas de los usuarios, mejorando la precisión y la velocidad de las búsquedas de documentación asistidas por IA.
-
- Los archivos de índice `llms.txt` generados automáticamente no pueden superar los 100.000 caracteres. Para sitios de documentación grandes, Mintlify divide el índice en archivos enlazados bajo `/_llms/` para que los agentes puedan descubrir cada página sin cargar un único archivo demasiado grande. Este límite no se aplica a `llms-full.txt`.
-
+/*` ya incluye `/_llms/*`. Con reglas granulares, añade `/_llms/*` de forma explícita. Consulta [Proxy inverso](/es/deploy/reverse-proxy#routing-configuration) para obtener orientación sobre el enrutamiento.
-Si utilizas un proxy inverso o mantienes una lista de rutas permitidas, reenvía `/_llms/*` además de `/llms.txt` para que los agentes puedan seguir los enlaces del índice generado. Para documentación alojada en una ruta base, reenvía `/_llms/*` en su lugar. Los dominios personalizados gestionados por Mintlify no requieren configuración adicional. Consulta [Proxy inverso](/es/deploy/reverse-proxy#routing-configuration) para obtener orientación sobre el enrutamiento.
+
+ Un directorio como `/docs` en tu repositorio no establece la ruta base pública de tu sitio. Configura la ruta base en tu dashboard de Mintlify y usa el mismo prefijo en tu proxy inverso. De lo contrario, `llms.txt` puede ser accesible en el prefijo público mientras sus enlaces generados bajo `/_llms/` apuntan a otro lugar.
+
```mdx Example llms.txt
# Título del sitio
diff --git a/es/ai/mintlify-mcp.mdx b/es/ai/mintlify-mcp.mdx
index 1f8d72ff4..cd7006802 100644
--- a/es/ai/mintlify-mcp.mdx
+++ b/es/ai/mintlify-mcp.mdx
@@ -142,6 +142,21 @@ Cada sesión del Admin MCP se vincula a una sola rama de Git. El flujo es:
Llamar a `checkout` de nuevo con un `subdomain` o una rama distinta cambia qué sesión está activa. No descarta las demás. Para abandonar un borrador en curso en lugar de simplemente alejarte de él, llama a `discard_session`.
+Deployment branch | Ninguna | **Publish** directamente en su sitio en producción |
-| Deployment branch | Se requieren pull requests | **Create branch** para mover los cambios a una nueva branch |
-| Feature branch | Ninguna | **Save in branch**, **Create pull request** |
-| Feature branch | Se requieren pull requests | **Save in branch**, **Create pull request** |
-
-- **Publish**: Confirma y despliega sus cambios en su sitio en producción de inmediato.
-- **Save in branch**: Confirma sus cambios en la feature branch sin fusionarlos con su deployment branch.
-- **Create branch**: Mueve sus cambios pendientes a una nueva feature branch cuando se encuentra en una deployment branch protegida.
-- **Create pull request**: Abre una pull request dirigida a su deployment branch.
-
-Si no hay cambios pendientes, el editor desactiva las acciones de publicar y guardar.
-
-
- Su sitio en producción se actualiza después de que Mintlify compile y despliegue sus cambios. Esto suele tardar de 30 segundos a unos pocos minutos. Compruebe el estado del despliegue en su [panel](https://app.mintlify.com).
-
-
-
- Use nombres descriptivos para las branches de modo que pueda identificarlas fácilmente y otras personas comprendan para qué sirve cada una.
-
-
-
- Si cambia de branch cuando tiene cambios sin publicar, se le pedirá que lleve esos cambios a la nueva branch o que los deje atrás. Los cambios dejados atrás permanecen en su branch original.
-
-
-
- Para copiar el nombre de una branch, pase el cursor sobre la branch en el menú desplegable y haga clic en el icono de copiar. Esto resulta útil al compartir la branch con sus compañeros de equipo o al referenciarla en una pull request.
-
-
-
- 
-
-
-Copie la URL y envíela a los revisores. La vista previa se actualiza automáticamente cada vez que guarda en la branch.
-
-
- Configure reglas de protección de branches en su proveedor de Git para exigir pull requests. Consulte [About protected branches](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches) en la ayuda de GitHub o [Protected branches](https://docs.gitlab.com/user/project/repository/branches/protected/) en la ayuda de GitLab.
-
-
-
+ 
+
+
+Todos los [roles](/es/dashboard/roles) pueden comentar y responder, incluidos los viewers. Solo los editors y admins pueden resolver hilos. Resolver un hilo lo quita de la barra lateral y elimina el resaltado de la página.
+
+Puede eliminar sus propios comentarios y los admins pueden eliminar cualquier comentario. Eliminar el primer comentario de un hilo elimina el hilo completo.
+
+Escriba `@` para mencionar a un compañero. Debe ser miembro de su organización y recibirá una notificación por correo electrónico.
+
+Si su branch tiene una pull request abierta, Mintlify añade a su descripción un resumen de los hilos sin resolver, con un enlace a cada comentario. El resumen se actualiza a medida que cambian los hilos.
+
+
+ Los [viewers](/es/dashboard/roles) están siempre en modo de sugerencias. El modo de sugerencias se activa automáticamente cuando un viewer abre el editor, de forma que pueda proponer cambios sin editar el contenido directamente.
+
+
+Haga clic en una sugerencia resaltada para aceptarla o rechazarla. Cualquiera de las dos opciones resuelve y elimina el hilo de la sugerencia. Un cambio aceptado pasa a formar parte de su branch actual y se publica la próxima vez que [publique](/es/editor/publish).
+
+
- 
-
-
-
- 
-
-
-
- 
-
-
-El panel agrupa los ajustes en secciones que se corresponden con las propiedades de nivel superior de su [`docs.json`](/es/organize/settings).
-
-
- 
-
-
-Para añadir una redirección:
-
-1. Haga clic en **Add redirect**.
-2. Introduzca el origen y el destino.
-3. Haga clic en **Save**.
-
-Para editar o eliminar una redirección existente, pase el cursor sobre la fila y use el icono de edición en línea o la **X** para eliminarla.
-
-
-
- Una instantánea guardada de sus cambios en un momento específico. Cada commit incluye un mensaje que describe qué cambió y crea un registro permanente en el historial de su proyecto.
-
- Cuando publica cambios, el editor web crea un commit en su repositorio de Git.
-
-
- Una línea de trabajo independiente en su repositorio. A veces se le llama **feature branch**.
-
- Su sitio en producción se compila desde una **deployment branch**, normalmente llamada `main`. Otras branches le permiten trabajar en cambios de forma independiente sin afectar a su sitio en producción. Nada en una branch se publica hasta que la fusiona con su deployment branch mediante una pull request.
-
- Cambie entre branches usando el menú desplegable de branches en la barra de herramientas del editor. Si tiene cambios sin publicar, el editor le permite llevarlos a la nueva branch o dejarlos en su branch actual.
-
-
- La branch que compila su sitio en producción, normalmente llamada `main`. Los cambios fusionados en esta branch se despliegan automáticamente en su sitio.
-
-
- Una propuesta para fusionar cambios de una branch en otra. Las pull requests permiten que su equipo revise y discuta los cambios antes de que se publiquen.
-
- Cuando publica cambios en una feature branch (o cuando su repositorio exige pull requests), el editor web crea una pull request. Su equipo revisa y fusiona la pull request en su proveedor de Git (GitHub, GitLab o Bitbucket).
-
-
- Combinar cambios de una branch en otra. Después de que su equipo revisa y aprueba una pull request, fusionar la branch incorpora sus cambios en la deployment branch y los publica.
-
-
- Ocurre cuando dos branches tienen cambios incompatibles en los mismos archivos. El editor le ayuda a resolver los conflictos cuando se producen.
-
-
- Una comparación que muestra las diferencias entre dos versiones de un archivo. El editor muestra un diff visual de sus cambios pendientes antes de publicar para que pueda revisar exactamente lo que se va a confirmar.
-
-
-
-` |
-| Cambiar de branch | `git checkout ` |
-| Push externo o actualización desde la CLI | Los cambios entrantes se sincronizan en el editor automáticamente mediante una fusión a tres bandas. |
diff --git a/es/editor/index.mdx b/es/editor/index.mdx
index 5f245a6b5..1742d4292 100644
--- a/es/editor/index.mdx
+++ b/es/editor/index.mdx
@@ -1,21 +1,17 @@
---
title: "Descripción general del editor"
sidebarTitle: "Descripción general"
-description: "Cree, edite y publique contenido en el navegador con colaboración en tiempo real, guardado automático, vistas previas en vivo y sincronización con Git."
-keywords: ["editor", "visual", "collaborative", "web editor"]
+description: "Cree, edite y publique contenido en su navegador con el editor de Mintlify. Admite colaboración en tiempo real y sincronización continua con Git."
+keywords: ["web editor", "git", "branches", "commits", "pull requests"]
---
-
- Un recorrido paso a paso: cree una branch, haga un cambio, comparta una vista previa y publique.
+
+ Cree una branch, haga un cambio, comparta una vista previa y publique.
-
- Si el editor alguna vez parece estar desincronizado con su repositorio, use [Reset editor](/es/editor/settings#reset-editor) para forzar una resincronización desde Git. Por ejemplo, el árbol de archivos está vacío o muestra `Unable to find docs.json` aunque el archivo esté presente en su deployment branch.
-
+**Git se mantiene sincronizado.** Cuando alguien hace push a su repositorio, esos cambios aparecen automáticamente. No necesita hacer pull ni actualizar la página. El editor combina los cambios que no entran en conflicto y señala todo lo que requiere su atención.
-**Publicar escribe en Git.** Cuando publica, el editor confirma sus cambios en su repositorio. En una deployment branch, esto actualiza su sitio en producción de inmediato. En una feature branch, crea una pull request.
+**Su equipo edita en conjunto.** Varias personas pueden editar la misma página a la vez, con cursores en vivo que muestran quién trabaja en cada parte. Los comentarios y las sugerencias son visibles para todos.
-**Su equipo edita en conjunto.** Varias personas pueden editar la misma página al mismo tiempo. Los cursores en vivo muestran quién está editando y dónde.
+
+ Si el editor alguna vez parece estar desincronizado con su repositorio, use [Restablecer editor](/es/editor/settings#reset-editor) para forzar una resincronización. Por ejemplo, aparece un árbol de archivos vacío o el error `Unable to find docs.json` cuando el archivo sí está presente en su deployment branch.
+
-
+ ## Índices divididos bajo `/_llms`
+
+
+Los archivos de índice `llms.txt` generados automáticamente no pueden superar los 100.000 caracteres. Cuando un índice supera este límite, Mintlify mantiene el archivo `llms.txt` principal como un directorio y traslada grupos de enlaces de páginas a archivos Markdown generados bajo `/_llms/`. Todas las páginas siguen siendo descubribles: la división nunca omite páginas del índice. Este límite no se aplica a `llms-full.txt`.
+
+Los enlaces a los índices generados aparecen en una sección `Indexes`. Cada enlace incluye la ruta de navegación del grupo, su número de páginas y una descripción:
+
+```mdx
+> The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages.
+
+## Indexes
+
+- [API reference (250 pages)](https://docs.example.com/_llms/api-reference.md): Endpoint documentation for the example API
+```
+
+Un índice generado puede enlazar a otros índices. Por ejemplo, `/_llms/api-reference.md` puede enlazar a `/_llms/api-reference/admin.md` cuando un grupo es demasiado grande para un solo archivo. Los agentes deben seguir estos enlaces de índice de forma recursiva hasta llegar a los enlaces de las páginas de documentación. Mintlify puede acortar las descripciones de las páginas en un índice dividido para mantener cada archivo por debajo del límite de caracteres.
+
+Los archivos generados forman parte de `llms.txt` y no necesitan existir en tu repositorio. Son independientes de `llms-full.txt`.
+
+La ruta `/_llms/` usa la misma ruta base que tu documentación:
+
+- Un sitio alojado en la raíz sirve un índice en `https://docs.example.com/_llms/api-reference.md`.
+- Un sitio alojado en `/docs` lo sirve en `https://example.com/docs/_llms/api-reference.md`.
+
+Si utilizas un proxy inverso o una lista de rutas permitidas, reenvía la ruta generada además de `llms.txt`. Una regla amplia `
+ ## Publicación
+
+
+La sección **Publicación** en la página de configuración del Admin MCP de tu panel controla qué ocurre cuando `save` se ejecuta con `mode: "auto"`. Activa **Enviar directamente a tu rama de despliegue** para que Mintlify envíe los cambios directamente a tu rama de despliegue. Desactívalo para que `save` abra una pull request en su lugar.
+
+Este interruptor comparte el mismo ajuste `agentReviewProcess` que los agentes de Slack y del panel, por lo que cualquier cambio aquí también se aplica a esos flujos.
+
+El interruptor se deshabilita en dos casos:
+
+- **Tu rama de despliegue requiere una pull request.** Si las reglas de protección de rama o las aprobaciones requeridas impiden los push directos, los cambios del MCP siempre abren una pull request, independientemente de este ajuste.
+- **Mintlify aloja tu implementación.** Para los sitios alojados por Mintlify, los cambios del MCP siempre se envían directamente, a menos que la protección de rama aún requiera una pull request.
+
+También puedes anular el ajuste caso por caso pasando un `mode` explícito a `save`: `"pr"` siempre abre una pull request, y `"commit"` hace push a una rama de PR existente sin abrir una nueva PR.
+
## Qué puede hacer el Admin MCP
diff --git a/es/deploy/reverse-proxy.mdx b/es/deploy/reverse-proxy.mdx
index feb262efc..42ce33171 100644
--- a/es/deploy/reverse-proxy.mdx
+++ b/es/deploy/reverse-proxy.mdx
@@ -16,6 +16,8 @@ Al implementar un proxy inverso, supervisa posibles problemas con la verificaci
Configura tu ruta base en la página de [configuración de dominio personalizado](https://app.mintlify.com/settings/deployment/custom-domain) en tu dashboard y, luego, configura tu proxy inverso para enrutar esa ruta a Mintlify. La ruta base predeterminada es `/docs`, pero puedes usar cualquier ruta base que elijas, como `/help` o `/resources`.
+El directorio que contiene tu documentación en tu repositorio no configura la ruta base pública. Por ejemplo, almacenar la documentación en un directorio `/docs` no sustituye establecer `/docs` como ruta base en tu dashboard.
+
En todas las configuraciones, usa `mintlify.site` como destino del proxy.
@@ -46,6 +48,7 @@ Redirige mediante proxy estas rutas a tu subdominio de Mintlify:
| --------------------------------- | ------------------------------------ | -------- |
| `/docs` | `.mintlify.site/docs` | Sin caché |
| `/docs/*` | `.mintlify.site/docs/*` | Sin caché |
+| `/docs/_llms/*` | `.mintlify.site/docs/_llms/*` | Sin caché |
| `/.well-known/vercel/*` | `.mintlify.site/.well-known/vercel/*` | Sin caché |
| `/.well-known/skills/*` (opcional) | `.mintlify.site/docs/.well-known/skills/*` | Sin caché |
| `/.well-known/agent-skills/*` (opcional) | `.mintlify.site/docs/.well-known/agent-skills/*` | Sin caché |
@@ -57,6 +60,10 @@ Tu proxy debe reenviar todos los métodos HTTP en las rutas de documentación. M
Mintlify sirve estos archivos bajo tu ruta base, como `.mintlify.site/docs/llms.txt`, de modo que están disponibles en tu dominio bajo tu subruta, como `your-domain.com/docs/llms.txt`, a través de tu ruta de subruta principal.
+La ruta `/docs/*` también cubre los índices `llms.txt` generados bajo `/docs/_llms/*`. Si tu proxy usa una lista de rutas permitidas más granular en lugar de reenviar todas las solicitudes de `/docs/*`, incluye `/docs/_llms/*` para que los agentes puedan seguir todos los índices enlazados desde `/docs/llms.txt`.
+
+No reescribas solo `/docs/llms.txt` hacia un `/llms.txt` alojado en la raíz. Establece `/docs` como la ruta base del despliegue y reenvía la ruta completa `/docs/*`. Esto mantiene los enlaces de las páginas y los enlaces de índice generados bajo `/docs/_llms/*` en el mismo prefijo público.
+
Las rutas `/.well-known/skills/*`, `/.well-known/agent-skills/*`, `/skill.md`, `/llms.txt` y `/llms-full.txt` son opcionales. Inclúyelas solo si también quieres servir estos archivos en rutas raíz de tu dominio, como `your-domain.com/llms.txt`. Ten en cuenta que cada ruta raíz se mapea al archivo bajo tu ruta base en tu subdominio de Mintlify.
-Haga clic en el icono del reloj en el encabezado del panel para ver sus sesiones de chat anteriores. Haga clic en cualquier sesión para volver a abrirla y ver lo que cambió el agente.
+Haga clic en el icono del reloj en el encabezado del panel para ver sus sesiones de chat anteriores. Haga clic en cualquier sesión para reabrirla y ver qué cambió el agente.
@@ -220,6 +227,20 @@ Configura tu proxy inverso usando la misma [configuración de enrutamiento](#rou
- Elimina el reenvío del encabezado `Host`
- Configura el encabezado `Origin` con tu subdominio de Mintlify (`.mintlify.site`)
+/*` o añade `/_llms/*` a una lista de rutas permitidas granular.
+- Vuelve a desplegar tu documentación y luego verifica tanto `/llms.txt` como una URL enlazada `/_llms/*.md`.
+
- Les fichiers d'index `llms.txt` générés automatiquement ne peuvent pas dépasser 100 000 caractères. Pour les sites de documentation volumineux, Mintlify scinde l'index en fichiers liés sous `/_llms/` afin que les agents puissent découvrir chaque page sans charger un seul fichier trop volumineux. Cette limite ne s'applique pas à `llms-full.txt`.
-
+/*` inclut déjà `/_llms/*`. Avec des règles granulaires, ajoutez explicitement `/_llms/*`. Consultez [Reverse proxy](/fr/deploy/reverse-proxy#routing-configuration) pour des conseils de routage.
-Si vous utilisez un reverse proxy ou maintenez une liste d'autorisation de chemins, transférez `/_llms/*` en plus de `/llms.txt` pour que les agents puissent suivre les liens de l'index généré. Pour une documentation hébergée sous un chemin de base, transférez `/_llms/*` à la place. Les domaines personnalisés gérés par Mintlify ne nécessitent aucune configuration supplémentaire. Consultez [Reverse proxy](/fr/deploy/reverse-proxy#routing-configuration) pour des conseils de routage.
+
+ Un répertoire tel que `/docs` dans votre référentiel ne définit pas le chemin de base public de votre site. Configurez le chemin de base dans votre Dashboard Mintlify et utilisez le même préfixe dans votre reverse proxy. Sinon, `llms.txt` peut être accessible au préfixe public alors que ses liens `/_llms/` générés pointent ailleurs.
+
```mdx Example llms.txt
# Titre du site
diff --git a/fr/ai/mintlify-mcp.mdx b/fr/ai/mintlify-mcp.mdx
index 9f9055a57..c0fb73ccd 100644
--- a/fr/ai/mintlify-mcp.mdx
+++ b/fr/ai/mintlify-mcp.mdx
@@ -142,6 +142,21 @@ Chaque session Admin MCP est liée à une seule branche Git. Le flux est le suiv
Appeler `checkout` à nouveau avec un `subdomain` ou une branche différente change la session active. Cela ne supprime pas les autres. Pour abandonner un brouillon en cours plutôt que de simplement en changer, appelez `discard_session`.
+
-Cuando abres el editor desde una ejecución de automatización completada haciendo clic en **Ver cambios**, el panel del agente se abre automáticamente con contexto sobre lo que hizo la automatización. Una tarjeta de **Páginas modificadas** en la parte superior del chat lista cada página que la automatización modificó: haz clic en cualquier página para abrir una vista de diff.
+Cuando abre el editor desde una ejecución de automatización completada haciendo clic en **View changes**, el panel del agente se abre automáticamente con contexto sobre lo que hizo la automatización. Una tarjeta **Changed pages** en la parte superior del chat enumera todas las páginas que modificó la automatización. Haga clic en cualquier página para abrir una vista de diff.
-El agente tiene contexto sobre el prompt de la automatización, un resumen de los cambios que realizó y qué páginas modificó. Puedes pedirle que refine o amplíe el trabajo de la automatización sin tener que volver a explicar el contexto.
+El agente dispone del prompt de la automatización, de un resumen de los cambios que hizo y de las páginas que modificó. Puede pedirle que refine o amplíe su trabajo sin volver a explicarle el contexto.
Por ejemplo: `The new section on rate limits is too long. Trim it to three sentences.`
@@ -164,7 +154,7 @@ Por ejemplo: `The new section on rate limits is too long. Trim it to three sente
+ ### Los enlaces generados bajo `/_llms/` devuelven 404
+
+
+**Síntomas**: Tu archivo `llms.txt` carga, pero los enlaces bajo `/_llms/` devuelven 404 u omiten tu subruta pública.
+
+**Causa**: La subruta pública no coincide con la ruta base configurada en Mintlify, o el proxy solo reenvía `llms.txt` y no sus rutas de índice generadas.
+
+**Solución**:
+
+- Establece la subruta pública como ruta base en tu dashboard de Mintlify. Un directorio del repositorio con el mismo nombre no la configura.
+- Reenvía la ruta completa `
### Problemas de rendimiento
diff --git a/fr/ai/llmstxt.mdx b/fr/ai/llmstxt.mdx
index 0b904befc..a5f9130c0 100644
--- a/fr/ai/llmstxt.mdx
+++ b/fr/ai/llmstxt.mdx
@@ -57,11 +57,36 @@ Les fichiers `llms.txt` et `llms-full.txt` répertorient les pages de votre lang
Cette approche structurée permet aux LLMs de traiter efficacement votre documentation à un niveau global et de repérer le contenu pertinent pour les requêtes des utilisateurs, améliorant ainsi la précision et la rapidité des recherches documentaires assistées par l'IA.
-
+ ## Index scindés sous `/_llms`
+
+
+Les fichiers d'index `llms.txt` générés automatiquement ne peuvent pas dépasser 100 000 caractères. Lorsqu'un index dépasse cette limite, Mintlify conserve le fichier `llms.txt` principal comme répertoire et déplace des groupes de liens de pages vers des fichiers Markdown générés sous `/_llms/`. Chaque page reste découvrable : la scission n'omet jamais de pages de l'index. Cette limite ne s'applique pas à `llms-full.txt`.
+
+Les liens vers les index générés apparaissent dans une section `Indexes`. Chaque lien inclut le fil d'Ariane du groupe, son nombre de pages et une description :
+
+```mdx
+> The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages.
+
+## Indexes
+
+- [API reference (250 pages)](https://docs.example.com/_llms/api-reference.md): Endpoint documentation for the example API
+```
+
+Un index généré peut pointer vers d'autres index. Par exemple, `/_llms/api-reference.md` peut pointer vers `/_llms/api-reference/admin.md` lorsqu'un groupe est trop volumineux pour un seul fichier. Les agents doivent suivre ces liens d'index de manière récursive jusqu'à atteindre les liens des pages de documentation. Mintlify peut raccourcir les descriptions de pages dans un index scindé pour maintenir chaque fichier sous la limite de caractères.
+
+Les fichiers générés font partie de `llms.txt` et n'ont pas besoin d'exister dans votre référentiel. Ils sont distincts de `llms-full.txt`.
+
+La route `/_llms/` utilise le même chemin de base que votre documentation :
+
+- Un site hébergé à la racine sert un index à l'adresse `https://docs.example.com/_llms/api-reference.md`.
+- Un site hébergé sous `/docs` le sert à l'adresse `https://example.com/docs/_llms/api-reference.md`.
+
+Si vous utilisez un reverse proxy ou une liste d'autorisation de chemins, transférez la route générée en plus de `llms.txt`. Une règle large `
+ ## Publication
+
+
+La section **Publication** de la page des paramètres de l'Admin MCP dans votre tableau de bord contrôle ce qui se passe lorsque `save` s'exécute avec `mode: "auto"`. Activez **Pousser directement sur votre branche de déploiement** pour que Mintlify pousse les modifications directement sur votre branche de déploiement. Désactivez-la pour que `save` ouvre une pull request à la place.
+
+Ce bouton partage le même paramètre `agentReviewProcess` que l'agent Slack et l'agent du tableau de bord, donc toute modification ici s'applique également à ces flux.
+
+Le bouton est désactivé dans deux cas :
+
+- **Votre branche de déploiement requiert une pull request.** Si des règles de protection de branche ou des approbations requises empêchent les push directs, les modifications MCP ouvrent toujours une pull request, quel que soit ce paramètre.
+- **Mintlify héberge votre déploiement.** Pour les sites hébergés par Mintlify, les modifications MCP sont toujours poussées directement, sauf si la protection de branche exige tout de même une pull request.
+
+Vous pouvez également remplacer ce paramètre appel par appel en passant un `mode` explicite à `save` : `"pr"` ouvre toujours une pull request, et `"commit"` pousse sur une branche de PR existante sans ouvrir de nouvelle PR.
+
## Ce que l'Admin MCP peut faire
diff --git a/fr/deploy/reverse-proxy.mdx b/fr/deploy/reverse-proxy.mdx
index ed1a061a5..4a150650e 100644
--- a/fr/deploy/reverse-proxy.mdx
+++ b/fr/deploy/reverse-proxy.mdx
@@ -16,6 +16,8 @@ Lorsque vous mettez en place un proxy inverse, surveillez les problèmes potenti
Définissez votre chemin de base sur la page [Configuration du domaine personnalisé](https://app.mintlify.com/settings/deployment/custom-domain) de votre Dashboard, puis configurez votre proxy inverse pour acheminer ce chemin vers Mintlify. Le chemin de base par défaut est `/docs`, mais vous pouvez utiliser n’importe quel chemin de base de votre choix, comme `/help` ou `/resources`.
+Le répertoire qui contient votre documentation dans votre référentiel ne configure pas le chemin de base public. Par exemple, stocker la documentation dans un répertoire `/docs` ne remplace pas la définition de `/docs` comme chemin de base dans votre Dashboard.
+
Dans toutes les configurations, utilisez `mintlify.site` comme cible du proxy.
@@ -46,6 +48,7 @@ Redirigez ces chemins via un proxy vers votre sous-domaine Mintlify :
| --------------------------------- | ------------------------------------ | -------- |
| `/docs` | `.mintlify.site/docs` | No cache |
| `/docs/*` | `.mintlify.site/docs/*` | No cache |
+| `/docs/_llms/*` | `.mintlify.site/docs/_llms/*` | No cache |
| `/.well-known/vercel/*` | `.mintlify.site/.well-known/vercel/*` | No cache |
| `/.well-known/skills/*` (optional) | `.mintlify.site/docs/.well-known/skills/*` | No cache |
| `/.well-known/agent-skills/*` (optional) | `.mintlify.site/docs/.well-known/agent-skills/*` | No cache |
@@ -57,6 +60,10 @@ Votre proxy doit transmettre toutes les méthodes HTTP sur les chemins de docume
Mintlify sert ces fichiers sous votre chemin de base, comme `.mintlify.site/docs/llms.txt`, ils sont donc disponibles sur votre domaine sous votre sous-chemin, comme `your-domain.com/docs/llms.txt`, via votre route principale de sous-chemin.
+La route `/docs/*` couvre également les index `llms.txt` générés sous `/docs/_llms/*`. Si votre proxy utilise une liste d'autorisation de chemins plus granulaire au lieu de transférer toutes les requêtes `/docs/*`, incluez `/docs/_llms/*` afin que les agents puissent suivre chaque index lié depuis `/docs/llms.txt`.
+
+Ne réécrivez pas uniquement `/docs/llms.txt` vers un `/llms.txt` hébergé à la racine. Définissez `/docs` comme chemin de base du déploiement et transférez la route `/docs/*` complète. Cela maintient les liens de pages et les liens d'index `/docs/_llms/*` générés sur le même préfixe public.
+
Les routes `/.well-known/skills/*`, `/.well-known/agent-skills/*`, `/skill.md`, `/llms.txt` et `/llms-full.txt` sont facultatives. Ne les incluez que si vous souhaitez également servir ces fichiers à des chemins racine sur votre domaine, comme `your-domain.com/llms.txt`. Notez que chaque chemin racine correspond au fichier situé sous votre chemin de base sur votre sous-domaine Mintlify.
-El agente puede escribir, reescribir, ampliar y reorganizar contenido en cualquier página. Lee su contenido existente para adaptarse a su estilo y estructura.
+El agente puede escribir, reescribir, ampliar y reorganizar el contenido de cualquier página. Lee su contenido existente para adaptarse a su estilo y estructura.
-El agente puede buscar en todo su repositorio, no solo en la página que tiene abierta. Úselo para encontrar información, comprobar inconsistencias o verificar que el contenido existe antes de añadirlo.
+El agente puede buscar en todo su repositorio, no solo en la página que tiene abierta. Úselo para encontrar información, detectar incoherencias o comprobar que un contenido ya existe antes de añadirlo.
-
-Para solicitudes que van más allá de editar páginas (configurar autenticación, gestionar workflows o cambiar ajustes de despliegue), el agente cambia a code mode. Escribe y ejecuta un script contra su panel de Mintlify en su nombre.
+Para solicitudes que van más allá de editar páginas (configurar la autenticación, gestionar workflows o cambiar los ajustes del deployment), el agente pasa al code mode. Escribe y ejecuta un script contra su dashboard de Mintlify en su nombre.
-Code mode respeta sus permisos del panel. Si no tiene acceso a un ajuste en el panel, el agente tampoco puede cambiarlo.
+El code mode respeta sus permisos del dashboard. Si no tiene acceso a un ajuste en el dashboard, el agente tampoco puede cambiarlo.
-Ejemplos de prompts que usan code mode:
+Prompts de ejemplo que usan code mode:
- `enable JWT authentication for my site`
- `create a workflow that updates my site when I merge a PR`
@@ -152,9 +142,9 @@ Ejemplos de prompts que usan code mode:
@@ -220,6 +227,20 @@ Configurez votre proxy inverse en utilisant la même [configuration de routage](
- Supprimez le transfert de l’en-tête `Host`
- Définissez l’en-tête `Origin` sur votre sous-domaine Mintlify (`.mintlify.site`)
+/*` complète, ou ajoutez `/_llms/*` à une liste d'autorisation granulaire.
+- Redéployez votre documentation, puis vérifiez à la fois `/llms.txt` et une URL `/_llms/*.md` liée.
+
- 自动生成的 `llms.txt` 索引文件不能超过 100,000 个字符。对于大型文档站点，Mintlify 会将索引拆分为位于 `/_llms/` 下的多个链接文件，使代理无需加载单个超大文件即可发现所有页面。此限制不适用于 `llms-full.txt`。
-
+/*` 规则已经包含 `/_llms/*`。如果使用细粒度规则，请显式添加 `/_llms/*`。有关路由指引，请参见[反向代理](/zh/deploy/reverse-proxy#routing-configuration)。
-如果你使用反向代理或维护路径允许列表，请在转发 `/llms.txt` 的同时转发 `/_llms/*`，以便代理能够跟随生成的索引链接。对于托管在基础路径下的文档，改为转发 `/_llms/*`。由 Mintlify 管理的自定义域名无需额外配置。有关路由指引，请参见[反向代理](/zh/deploy/reverse-proxy#routing-configuration)。
+
+ 仓库中诸如 `/docs` 之类的目录不会设置站点的公开基础路径。请在 Mintlify 控制台中配置基础路径，并在反向代理中使用相同的前缀。否则，`llms.txt` 可能可以通过公开前缀访问，而其生成的 `/_llms/` 链接却指向其他位置。
+
```mdx Example llms.txt
# 站点标题
diff --git a/zh/ai/mintlify-mcp.mdx b/zh/ai/mintlify-mcp.mdx
index 8c87f729b..e95775ccc 100644
--- a/zh/ai/mintlify-mcp.mdx
+++ b/zh/ai/mintlify-mcp.mdx
@@ -142,6 +142,21 @@ keywords: ["MCP", "写入权限", "AI", "编辑", "Claude", "ChatGPT", "Cursor",
使用不同的 `subdomain` 或 branch 再次调用 `checkout` 会切换当前活动的会话，而不会丢弃其他会话。若要放弃进行中的草稿而不仅仅是切换离开它，请调用 `discard_session`。
+
- [Instalar la CLI](/es/cli/install): Instala la CLI y prepárala para usarla.
+- [Extensión Mintlify MDX](/es/cli/mdx-extension): Agrega autocompletado, verificación de errores en línea y una previsualización en el editor.
- [Previsualización local](/es/cli/preview): Ejecuta un servidor de desarrollo local con soporte de búsqueda y asistente.
- [Comandos](/es/cli/commands): Referencia completa de todos los comandos y flags.
diff --git a/es/cli/install.mdx b/es/cli/install.mdx
index 3e8609fc7..73737d430 100644
--- a/es/cli/install.mdx
+++ b/es/cli/install.mdx
@@ -121,14 +121,16 @@ Si `mint update` no está disponible en tu versión, reinstala la CLI con la úl
```
-
+ ### Les liens `/_llms/` générés renvoient une erreur 404
+
+
+**Symptômes** : votre fichier `llms.txt` se charge, mais les liens sous `/_llms/` renvoient une erreur 404 ou omettent votre sous-chemin public.
+
+**Cause** : le sous-chemin public ne correspond pas au chemin de base configuré dans Mintlify, ou le proxy ne transfère que `llms.txt` et non ses routes d'index générées.
+
+**Solution** :
+
+- Définissez le sous-chemin public comme chemin de base dans votre Dashboard Mintlify. Un répertoire du référentiel portant le même nom ne le configure pas.
+- Transférez la route `
### Problèmes de performances
diff --git a/poc-onboarding.mdx b/poc-onboarding.mdx
index 14733a9e8..793d2c5f7 100644
--- a/poc-onboarding.mdx
+++ b/poc-onboarding.mdx
@@ -114,7 +114,7 @@ Open the [Members](https://app.mintlify.com/settings/organization/members) page
See [Roles](/dashboard/roles) for a complete permissions list.
-Invite at least one writer who does not use Git, one engineer, and the decision maker. Use their work email addresses so their accounts can connect to your identity provider.
+Invite at least one writer who does not use Git, one engineer, and the decision maker. Use their work email addresses so their accounts can connect to your identity provider if you test authentication.
## Step 3: Add sample content
diff --git a/zh/ai/llmstxt.mdx b/zh/ai/llmstxt.mdx
index 354db76cc..fe5f875ac 100644
--- a/zh/ai/llmstxt.mdx
+++ b/zh/ai/llmstxt.mdx
@@ -57,11 +57,36 @@ X-Llms-Txt: /llms.txt
这种结构化方法使 LLM 能够高效地从宏观层面处理你的文档，并为用户查询定位相关内容，从而提升 AI 辅助文档搜索的准确性和速度。
-
+ ## `/_llms` 下的拆分索引
+
+
+自动生成的 `llms.txt` 索引文件不能超过 100,000 个字符。当索引超过此限制时，Mintlify 会将主 `llms.txt` 文件保留为目录形式，并将成组的页面链接移入位于 `/_llms/` 下的生成 Markdown 文件中。所有页面仍然可被发现：拆分绝不会从索引中省略页面。此限制不适用于 `llms-full.txt`。
+
+指向生成索引的链接会出现在 `Indexes` 部分。每个链接都包含该分组的面包屑路径、页面数量和描述：
+
+```mdx
+> The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages.
+
+## Indexes
+
+- [API reference (250 pages)](https://docs.example.com/_llms/api-reference.md): Endpoint documentation for the example API
+```
+
+生成的索引可以链接到更深层的索引。例如，当某个分组过大而无法放入单个文件时，`/_llms/api-reference.md` 可以链接到 `/_llms/api-reference/admin.md`。代理应递归跟随这些索引链接，直至到达文档页面链接。Mintlify 可能会缩短拆分索引中的页面描述，以使每个文件保持在字符限制以内。
+
+这些生成的文件属于 `llms.txt` 的一部分，无需存在于你的仓库中。它们与 `llms-full.txt` 相互独立。
+
+`/_llms/` 路由使用与你的文档相同的基础路径：
+
+- 托管在根路径下的站点会在 `https://docs.example.com/_llms/api-reference.md` 提供索引。
+- 托管在 `/docs` 下的站点会在 `https://example.com/docs/_llms/api-reference.md` 提供索引。
+
+如果你使用反向代理或路径允许列表，请在转发 `llms.txt` 的同时转发生成的路由。宽泛的 `
+ ## 发布
+
+
+控制台管理员 MCP 设置页面上的 **发布** 部分用于控制 `save` 在 `mode: "auto"` 下运行时的行为。开启 **直接推送到你的部署 branch**，Mintlify 会将更改直接推送到你的部署 branch。关闭它，`save` 将改为打开一个拉取请求。
+
+此开关与 Slack 和控制台代理共享相同的 `agentReviewProcess` 设置，因此在这里所做的任何更改都会同样应用于那些流程。
+
+以下两种情况下该开关会被禁用：
+
+- **你的部署 branch 需要拉取请求。** 如果 branch 保护规则或必需的审批阻止了直接推送，那么无论此设置如何，MCP 更改都会始终打开拉取请求。
+- **Mintlify 托管你的部署。** 对于由 Mintlify 托管的站点，MCP 更改会始终直接推送，除非 branch 保护仍然要求拉取请求。
+
+你也可以通过向 `save` 传递显式的 `mode` 来按调用覆盖该设置：`"pr"` 始终打开拉取请求，`"commit"` 会推送到现有的 PR branch 而不打开新的 PR。
+
## 管理员 MCP 可以做什么
diff --git a/zh/deploy/reverse-proxy.mdx b/zh/deploy/reverse-proxy.mdx
index 86a7693c9..cb5e7e5dd 100644
--- a/zh/deploy/reverse-proxy.mdx
+++ b/zh/deploy/reverse-proxy.mdx
@@ -16,6 +16,8 @@ import SubpathSetupSteps from "/snippets/zh/subpath-setup-steps.mdx";
在控制台的 [Custom domain setup](https://app.mintlify.com/settings/deployment/custom-domain) 页面上设置你的基础路径，然后将反向代理配置为把该路径路由到 Mintlify。默认基础路径是 `/docs`，但你可以使用任何你选择的基础路径，例如 `/help` 或 `/resources`。
+仓库中存放文档的目录并不会配置公开基础路径。例如，将文档存放在 `/docs` 目录下并不能替代在控制台中将 `/docs` 设置为基础路径。
+
在所有配置中，均使用 `mintlify.site` 作为代理目标。
@@ -46,6 +48,7 @@ import SubpathSetupSteps from "/snippets/zh/subpath-setup-steps.mdx";
| --------------------------------- | ------------------------------------ | -------- |
| `/docs` | `.mintlify.site/docs` | No cache |
| `/docs/*` | `.mintlify.site/docs/*` | No cache |
+| `/docs/_llms/*` | `.mintlify.site/docs/_llms/*` | No cache |
| `/.well-known/vercel/*` | `.mintlify.site/.well-known/vercel/*` | No cache |
| `/.well-known/skills/*` (可选) | `.mintlify.site/docs/.well-known/skills/*` | No cache |
| `/.well-known/agent-skills/*` (可选) | `.mintlify.site/docs/.well-known/agent-skills/*` | No cache |
@@ -57,6 +60,10 @@ import SubpathSetupSteps from "/snippets/zh/subpath-setup-steps.mdx";
Mintlify 会在你的基础路径下提供这些文件，例如 `.mintlify.site/docs/llms.txt`，因此它们可以通过你的主要子路径路由，在你域名的子路径下访问，例如 `your-domain.com/docs/llms.txt`。
+`/docs/*` 路由同样覆盖位于 `/docs/_llms/*` 下生成的 `llms.txt` 索引。如果你的代理使用更细粒度的路径允许列表，而不是转发所有 `/docs/*` 请求，请包含 `/docs/_llms/*`，以便代理能够跟随 `/docs/llms.txt` 中链接的每个索引。
+
+不要仅将 `/docs/llms.txt` 重写为托管在根路径的 `/llms.txt`。请将 `/docs` 设置为部署基础路径，并转发完整的 `/docs/*` 路由。这样可以让页面链接与生成的 `/docs/_llms/*` 索引链接保持在同一个公开前缀下。
+
`/.well-known/skills/*`、`/.well-known/agent-skills/*`、`/skill.md`、`/llms.txt` 和 `/llms-full.txt` 路由是可选的。只有当你还希望在域名的根路径下提供这些文件时（例如 `your-domain.com/llms.txt`）才需要包含它们。请注意，每个根路径都会映射到你 Mintlify 子域上基础路径下的文件。
` más claros para las ramas generadas automáticamente. Consulta [Ramas y publicación](/es/editor/branching-and-publishing).
+ - **Branches v2 e historial de versiones:** Las ramas del editor ahora se respaldan con pull requests en borrador y guardan automáticamente los cambios en Git. Puedes renombrar o eliminar ramas, descartar cambios guardados automáticamente y mover cambios pendientes a una rama nueva. El menú de ramas se ordena por actividad reciente, usa nombres por usuario y muestra nombres `Draft ` más claros para las ramas generadas automáticamente. Consulta [Ramas y publicación](/es/editor/publish).
- **Navegación simplificada del editor:** El editor tiene una nueva fila de breadcrumbs, controles de página y uso compartido consolidados, encabezados de sección fijos en la barra lateral y una barra inferior dedicada a la configuración y **Ask agent**. En pantallas pequeñas, la navegación móvil ahora usa una barra superior simplificada y una barra lateral en forma de panel.
- **Acceso a páginas y comentarios:** Solicita acceso de edición a una página privada o protegida desde el editor y revisa las solicitudes en un modal de aprobación. Las tarjetas de comentarios ahora muestran fotos de perfil y las @menciones enlazan al usuario mencionado.
- **Mejoras de live preview:** Ejecuta varias vistas previas locales al mismo tiempo. Los cambios de navegación se propagan a las vistas previas abiertas, el panel del agente se acopla a la izquierda y la vista previa permanece visible durante los turnos de seguimiento del onboarding.
@@ -179,7 +179,7 @@ noindex: true
- **Flujo de revisión:** Solicita la revisión de un borrador, deja comentarios y aprueba o solicita cambios antes de publicar. Las revisiones ahora admiten ramas que no son de despliegue.
- - **Más formas de colaborar:** Inicia [hilos de comentarios](/es/editor/comments) sobre una página completa, menciónate para dejar un recordatorio y usa los atajos de teclado Option + C u Option + S para comentar o sugerir cambios en el texto seleccionado.
+ - **Más formas de colaborar:** Inicia [hilos de comentarios](/es/editor/collaborate#comments) sobre una página completa, menciónate para dejar un recordatorio y usa los atajos de teclado Option + C u Option + S para comentar o sugerir cambios en el texto seleccionado.
- **Edición más rápida y disponible:** El editor se renderiza sin esperar al árbol de archivos de Git y las personas sin acceso de escritura en GitHub pueden usarlo.
@@ -220,6 +227,20 @@ Mintlify 会重新构建你的文档以在你的基础路径下提供服务，
- 停止转发 `Host` 头
- 将 `Origin` 头设置为你的 Mintlify 子域（`.mintlify.site`）
+/*` 路由，或在细粒度允许列表中添加 `/_llms/*`。
+- 重新部署文档，然后同时验证 `/llms.txt` 和一个链接的 `/_llms/*.md` URL。
+
` names for automatically generated branches. See [Branching and publishing](/editor/branching-and-publishing).
- - **Pull requests open as drafts by default:** The editor now opens new pull requests in draft state so you can share a preview URL without signaling that the change is ready to merge. Change this on the [editor settings](/editor/settings#create-pull-requests-as-drafts-by-default) page.
+ - **Editor branches:** When you create a branch, the editor now creates a draft pull request and autosaves changes to Git. You can rename or delete branches, discard autosaved changes, and move pending changes to a new branch. The branch menu is ordered by recent activity, uses per-user branch names, and shows cleaner `Draft ` names for automatically generated branches. See [Branching and publishing](/editor/publish).
+ - **Pull requests open as drafts by default:** The editor now opens new pull requests in draft state so you can share a preview URL without signaling that the change is ready to merge. Change this on the [editor settings](/editor/settings#create-draft-pull-requests-by-default) page.
- **GitLab merge requests:** Merge requests opened in GitLab now sync into editor branches, matching the existing GitHub behavior.
- **Streamlined editor navigation:** The editor has a new breadcrumbs row, consolidated page and share controls, sticky sidebar section headers, and a dedicated bottom bar for settings and **Ask agent**. Site settings open as editor pages instead of a modal. Mobile navigation now uses a simplified top bar and panel-based sidebar for smaller screens.
- **Page access and comments:** Request edit access to a private or protected page from the editor and review requests in an approval modal. Comment cards now show profile pictures, and @mentions link to the mentioned user.
@@ -111,7 +111,7 @@ noindex: true
- **Faster live previews:** Live previews load much faster on first open, new pages and `docs.json` changes appear sooner, and CSS and theme edits now update in real time.
- **Live preview in the editor:** Live previews open in an editor pane instead of a new tab, and site settings and the editor agent are available while you preview.
- - **Authenticated live previews:** Preview drafts of pages behind authentication from the editor [live preview](/editor/live-preview).
+ - **Authenticated live previews:** Preview drafts of pages behind authentication from the editor [live preview](/editor/review#live-preview).
- **OpenAPI 3.1 file uploads:** The API playground now recognizes OpenAPI 3.1 files uploaded to `FileInput` fields, and file inputs support drag-and-drop. See [OpenAPI setup](/api-playground/openapi-setup) for more information.
- **Markdown mode:** Use the `/` menu in Markdown mode, copy content as Markdown, and pasted Markdown in visual mode formats automatically.
- **Assistant analytics:** The assistant analytics view has more context and filtering than the previous version.
@@ -199,7 +199,7 @@ noindex: true
## Editor and collaboration
- **Review flow:** Request review on a draft, leave feedback, and approve or request changes before publishing. Reviews now support non-deploy branches.
- - **More ways to collaborate:** Start [comment threads](/editor/comments) on an entire page, mention yourself to leave a reminder, and use keyboard shortcuts Option + C or Option + S to comment on or suggest changes to selected text.
+ - **More ways to collaborate:** Start [comment threads](/editor/collaborate#comments) on an entire page, mention yourself to leave a reminder, and use keyboard shortcuts Option + C or Option + S to comment on or suggest changes to selected text.
- **Faster, more available editing:** The editor renders without waiting for the Git file tree and people without GitHub write access can use the editor.
## Automations, integrations, and Slack
@@ -918,7 +918,7 @@ noindex: true
- Redesigned the editor configuration settings page with an improved layout and autosave support.
- Pages auto-generated from OpenAPI specifications now appear in the web editor as read-only entries.
- - Video support in [live preview](/editor/live-preview). Embedded mp4, webm, and mov files now render correctly during local development.
+ - Video support in [live preview](/editor/review#live-preview). Embedded mp4, webm, and mov files now render correctly during local development.
- [Automations](/automations) can now be disabled and re-enabled from the dashboard.
- Assistant analytics now show usage broken down by source (web vs API) in the dashboard.
- Authenticated MCP search now correctly filters results based on the user's authentication groups.
@@ -1412,8 +1412,8 @@ noindex: true
## Web editor improvements
- - Added [shareable preview links](/editor/branching-and-publishing#access-and-share-a-preview) from the editor toolbar.
- - Updated [publishing workflow](/editor/branching-and-publishing) to support one-click publishing or creating pull requests.
+ - Added [shareable preview links](/editor/review#preview-deployments) from the editor toolbar.
+ - Updated [publishing workflow](/editor/publish) to support one-click publishing or creating pull requests.
- Working in the web editor no longer requires you to sign in with GitHub.
## Onboarding improvements
diff --git a/deploy/authentication-setup.mdx b/deploy/authentication-setup.mdx
index bf460f857..0e5b9eaea 100644
--- a/deploy/authentication-setup.mdx
+++ b/deploy/authentication-setup.mdx
@@ -518,4 +518,4 @@ Some features behave differently or are unavailable when you enable authenticati
| [skill.md](/ai/skillmd) | Full support | Not supported | Not supported |
| [Sitemap](/optimize/seo#sitemaps-and-robotstxt-files) | Full support | Available behind authentication, but excludes pages in groups | Available behind authentication, but excludes pages in groups |
| [robots.txt](/optimize/seo#sitemaps-and-robotstxt-files) | Full support | Available behind authentication | Available behind authentication |
-| [Live preview](/editor/live-preview) | Full support | Supported for Mintlify authentication | Supported for Mintlify authentication |
+| [Live preview](/editor/review#live-preview) | Full support | Supported for Mintlify authentication | Supported for Mintlify authentication |
diff --git a/docs.json b/docs.json
index a917458ea..43fedbdc4 100644
--- a/docs.json
+++ b/docs.json
@@ -122,15 +122,11 @@
"root": "editor/index",
"pages": [
"editor/tutorial",
- "editor/git-essentials",
"editor/pages",
- "editor/navigation",
- "editor/live-preview",
- "editor/branching-and-publishing",
- "editor/comments",
- "editor/suggestions",
+ "editor/publish",
+ "editor/review",
+ "editor/collaborate",
"editor/agent",
- "editor/configurations",
"editor/settings",
"editor/keyboard-shortcuts"
]
diff --git a/editor/agent.mdx b/editor/agent.mdx
index 3ac724e3b..a6d63b71e 100644
--- a/editor/agent.mdx
+++ b/editor/agent.mdx
@@ -10,17 +10,9 @@ The editor agent makes changes directly in your current branch.
## Open the agent
-{/* vale Mintlify.FirstPerson = NO */}
Click **Ask agent** in the editor toolbar, or press Cmd + I (macOS) or Ctrl + I (Windows).
-To close the panel, click the **X** button in the panel header or press Cmd + I again.
-{/* vale Mintlify.FirstPerson = YES */}
-
-## Send a message
-
-Type your request in the chat box at the bottom of the panel and press Enter or click the Deployment branch | None | **Publish** directly to your live site |
-| Deployment branch | Pull requests required | **Create branch** to move changes to a new branch |
-| Feature branch | None | **Save in branch**, **Create pull request** |
-| Feature branch | Pull requests required | **Save in branch**, **Create pull request** |
-
-- **Publish**: Commits and deploys your changes to your live site immediately.
-- **Save in branch**: Commits your changes to the feature branch without merging to your deployment branch.
-- **Create branch**: Moves your pending changes to a new feature branch when you're on a protected deployment branch.
-- **Create pull request**: Opens a pull request targeting your deployment branch.
-
-If there are no pending changes, the editor disables the publish and save actions.
-
-
- Your live site updates after Mintlify builds and deploys your changes. This typically takes 30 seconds to a few minutes. Check the deployment status on your [dashboard](https://app.mintlify.com).
-
-
-## When to use a branch
-
-**Edit directly on your deployment branch** if you do not use a Git-based workflow.
-
-**Create a branch** when you use a branch-based workflow where you make each change to your content on a separate branch.
-
-## Create and switch branches
-
-### Create a branch
-
-1. Click the branch name in the editor toolbar.
-2. Click **Create new branch**.
-3. If you have pending changes, choose whether to bring them to the new branch or leave them on the current branch.
-4. Enter a name and click **Create branch**.
-
-
- Use descriptive branch names so you can identify them and other people understand what each branch is for.
-
-
-### Switch branches
-
-1. Click the branch name in the toolbar.
-2. Search for or scroll to the branch you want.
-3. Click the branch to switch to it.
-
-
- Switching branches while you have unpublished changes prompts you to bring those changes to the new branch or leave them behind. Changes left behind remain on your original branch.
-
-
-
- To copy a branch name, hover over the branch in the dropdown and click the copy icon. This is useful when sharing the branch with teammates or referencing it in a pull request.
-
-
-## Preview your changes
-
-Every time you save changes to a feature branch, Mintlify builds a preview deployment, a temporary URL where your changes render exactly as they look when published.
-
-### Access and share a preview
-
-1. Click **Publish** in the editor toolbar.
-2. In the publish menu, click the preview URL. The URL format is `organization-branch-name.mintlify.site`.
-
-
-
-
-
-Copy the URL and send it to reviewers. The preview updates automatically each time you save to the branch.
-
-### Restrict access to previews
-
-Preview URLs are publicly accessible by default. To restrict access to members of your Mintlify organization, enable preview authentication in the [Add-ons](https://app.mintlify.com/products/addons) page of your dashboard.
-
-### Share editor links
-
-To invite a teammate to a specific page on a branch, copy the URL from your browser's address bar and share it. Anyone with access to your Mintlify organization can open the link directly in their editor session.
-
-The URL format is:
-
-```text
-https://app.mintlify.com/{org}/{project}/editor/{branch}/~/{filepath}
-```
-
-For example: `https://app.mintlify.com/acme/docs/editor/main/~/guides/quickstart.mdx`
-
-## Review and merge pull requests
-
-When a pull request is open for the current branch, the publish menu shows a review panel with:
-
-- The pull request title, description, and whether it is a draft.
-- The source and target branches.
-- The number of changed files.
-- The approval requirement on the deployment branch: **Approval required**, **Code owner required**, or no requirement.
-- The current review status: **Approved**, **Changes requested**, or **Awaiting review**.
-
-Click the pull request link to open it in GitHub, GitLab, or Bitbucket.
-
-After a reviewer approves a pull request, click **Merge and publish** to merge and deploy directly from the editor. The editor switches to your deployment branch after merging.
-
-### Approve pull requests from the editor
-
-For GitHub repositories, reviewers can approve open pull requests in the editor. When a pull request is open, an **Approve pull request** button appears in the review panel if your account has permission to review it. Click **Approve pull request** when the changes are ready to merge. The review status updates to **Approved** and the **Merge and publish** action becomes available.
-
-If you use GitLab or Bitbucket, open the pull request in your Git provider to approve it.
-
-
- Configure branch protection rules in your Git provider to require pull requests. See [About protected branches](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches) in the GitHub help or [Protected branches](https://docs.gitlab.com/user/project/repository/branches/protected/) in the GitLab help.
-
-
-### Review changes before merging
-
-Click any changed file in the publish menu to open it in diff view and compare your branch against the published version. In visual mode you see a visual diff. In source mode you see a text diff. Files that can't display a diff, such as images or deleted files, appear in the list but aren't clickable.
-
-The file tree highlights changed pages so you can see at a glance which files an [automation](/automations) or teammate touched. Unlisted pages that appear in the branch diff are also openable from the publish menu, even though they don't appear in your site navigation.
-
-### Open an automation run in the editor
-
-When an [automation](/automations) opens a pull request, you can jump straight from the run review UI or its Slack notification into the editor on the automation's branch:
-
-- From the **Automation Runs** page in your dashboard, click **Open in editor** on a completed run.
-- From a Slack notification, click the **View changes** link.
-
-Either entry point opens the editor on the automation's branch with the changed pages preselected in the publish menu. You can review the diff and merge or request changes without leaving the editor.
-
-### Simultaneous publishing
-
-Only one publish can happen at a time per branch. If another team member publishes to the same branch, wait for the current publish to complete before trying again.
-
-### Pull request titles and descriptions
-
-If your organization requires pull requests, you can enter a title and description when you publish. If you leave either blank, the editor uses a default message that lists the files you created, updated, moved, or deleted.
-
-## Resolve conflicts
-
-Conflicts occur when your branch and the deployment branch have incompatible changes to the same files. For example, when you and a teammate edited the same lines in a file or moved a file to different locations.
-
-The editor displays a warning when conflicts block publishing. Follow the prompts to choose which version of each conflicting section to keep.
-
-## Collaborate in real time
-
-When multiple people open the same page on the same branch, they edit together in real time. Each person's cursor and edits are visible to everyone, with avatars shown in the toolbar.
-
-- Changes from all collaborators merge automatically. Two people editing the same section won't create conflicts.
-- Undo only affects your own edits.
-- If you lose your connection, edits save locally and sync when you reconnect.
-
-When the [Mintlify agent](/agent) edits a page through the API or MCP, it appears in the editor like any other collaborator. You see the agent's avatar in the toolbar and a live cursor at its most recent edit location. The cursor clears automatically after the agent finishes.
-
-## Git sync
-
-When someone pushes changes to your repository from outside the editor, the editor incorporates those changes automatically.
-
-Non-overlapping changes apply automatically. If a remote change and your local edit affect the same part of a page, the editor highlights the conflict so you can resolve it.
-
-## Commit signing
-
-Sign commits with your GitHub account by authorizing it in your [account settings](https://app.mintlify.com/settings/account). Without authorization, the Mintlify GitHub App signs commits made in the web editor.
-
-For a reference of how editor actions map to Git operations, see [Git essentials](/editor/git-essentials#how-the-editor-maps-to-git).
diff --git a/editor/collaborate.mdx b/editor/collaborate.mdx
new file mode 100644
index 000000000..a5fa67588
--- /dev/null
+++ b/editor/collaborate.mdx
@@ -0,0 +1,66 @@
+---
+title: "Collaborate in the editor"
+sidebarTitle: "Collaborate"
+description: "Leave comments, propose changes as suggestions, and edit alongside teammates in real time in the editor."
+keywords: ["comments", "suggestions", "collaboration", "review", "mentions", "real time"]
+---
+
+Work with your team on a page by commenting on it, suggesting changes to it, or editing it together at the same time.
+
+## Comments
+
+Comments let you leave feedback on specific text without editing the content.
+
+**Comments never reach your repository.** They live only inside the editor and are never included in the published site or committed to Git.
+
+To add a comment, highlight text and click the
+ [Viewers](/dashboard/roles) are always in suggesting mode. Suggesting mode activates automatically when a viewer opens the editor so that they can propose changes without editing content directly.
+
+
+Click a highlighted suggestion to accept or reject it. Either choice resolves and deletes the suggestion thread. An accepted change becomes part of your current branch and goes live the next time you [publish](/editor/publish).
+
+## Ask the Mintlify agent
+
+Mention `@mintlify` in a comment, suggestion, or reply to ask the [editor agent](/editor/agent) about the current page. The agent runs in the background with the page, thread, and branch as context, then posts its answer as a reply in the same thread.
+
+```text
+@mintlify does this endpoint support pagination?
+@mintlify are there any pages that contradict this?
+```
+
+The agent runs read-only when replying to comments. It can search your docs, read pages, fetch web content, and load skills, but it cannot edit content, create suggestions, or publish. To make changes, open the [editor agent](/editor/agent) directly.
+
+Mentions work on private pages for members who already have access. Each reply counts toward your editor agent usage.
+
+## Real-time editing
+
+When multiple people open the same page on the same branch, they edit together. Each person's cursor and edits are visible to everyone, with avatars in the toolbar.
+
+- Changes from all collaborators merge automatically. Two people editing the same section won't create conflicts.
+- Undo only affects your own edits.
+- If you lose your connection, edits save locally and sync when you reconnect.
+
+When the [Mintlify agent](/agent) edits a page through the API or MCP, it appears like any other collaborator, with an avatar and a live cursor at its most recent edit. The cursor clears when the agent finishes.
diff --git a/editor/comments.mdx b/editor/comments.mdx
deleted file mode 100644
index 8db8f5b98..000000000
--- a/editor/comments.mdx
+++ /dev/null
@@ -1,97 +0,0 @@
----
-title: "Comment on pages in the editor"
-sidebarTitle: "Comments"
-description: "Leave inline comments on pages in the editor to give feedback, ask questions, mention teammates, and resolve threads before you publish changes."
-keywords: ["editor", "comments", "collaboration", "feedback", "mentions", "threads"]
----
-
-Comments let you and your team leave feedback on specific text in a page without editing the content. Use comments to ask questions, flag issues, or discuss changes before you publish them.
-
-Comments live only inside the editor. They are never included in the published site or committed to your repository.
-
-All [roles](/dashboard/roles)—viewers, editors, and admins—can leave and reply to comments. Only editors and admins can resolve comment threads.
-
-If your branch has an open pull request, Mintlify adds a summary of unresolved comment threads to the pull request description. The summary lists the files with open comments, the first comment in each thread, and a link to navigate to the comment in the editor.
-
-The summary updates when you add, resolve, or delete a comment.
-
-## Add a comment
-
-1. Highlight the text you want to comment on.
-2. Click the
-
- A saved snapshot of your changes at a specific point in time. Each commit includes a message describing what changed and creates a permanent record in your project history.
-
- When you publish changes, the web editor creates a commit in your Git repository.
-
-
- A separate line of work in your repository. Sometimes called a **feature branch**.
-
- Your live site builds from a **deployment branch**, usually called `main`. Other branches let you work on changes independently without affecting your live site. Nothing on a branch goes live until you merge it into your deployment branch with a pull request.
-
- Switch between branches using the branch dropdown in the editor toolbar. If you have unpublished changes, the editor lets you bring them to the new branch or leave them on your current branch.
-
-
- The branch that builds your live site, typically called `main`. Changes merged into this branch automatically deploy to your site.
-
-
- A proposal to merge changes from one branch into another. Pull requests let your team review and discuss changes before they go live.
-
- When you publish changes on a feature branch (or when your repository requires pull requests), the web editor creates a pull request. Your team reviews and merges the pull request in your Git provider (GitHub, GitLab, or Bitbucket).
-
-
- Combining changes from one branch into another. After your team reviews and approves a pull request, merging the branch incorporates your changes into the deployment branch and publishes them.
-
-
- Occurs when two branches have incompatible changes to the same files. The editor helps you resolve conflicts when they occur.
-
-
- A comparison showing the differences between two versions of a file. The editor shows a visual diff of your pending changes before you publish so you can review exactly what gets committed.
-
-
-
-## How the editor maps to Git
-
-Every action in the web editor corresponds to a Git operation. Here is the full reference:
-
-| Action in the editor | Git operation |
-|---|---|
-| Edit a page | Changes auto-save to Mintlify servers. No Git commit yet. |
-| Publish on your deployment branch | `git commit` and `git push`. Triggers a deployment. |
-| Save in branch | `git commit` to the current feature branch. |
-| Create pull request | `git push` and opens a pull request against your deployment branch. |
-| Merge and publish | Merges the pull request and triggers a deployment. |
-| Create a branch | `git checkout -b ` |
-| Switch branches | `git checkout ` |
-| External push or CLI update | Incoming changes sync into the editor automatically using a three-way merge. |
diff --git a/editor/index.mdx b/editor/index.mdx
index 3b14a32de..bf98d3468 100644
--- a/editor/index.mdx
+++ b/editor/index.mdx
@@ -1,84 +1,86 @@
---
title: "Editor overview"
sidebarTitle: "Overview"
-description: "Create, edit, and publish content in your browser with real-time team collaboration, automatic saving, live previews, and continuous Git sync."
-keywords: ["editor", "visual", "collaborative", "web editor"]
+description: "Create, edit, and publish content in your browser with the Mintlify editor. Supports real-time collaboration and continuous Git sync."
+keywords: ["web editor", "git", "branches", "commits", "pull requests"]
---
- A step-by-step walkthrough: create a branch, make a change, share a preview, and publish.
+ Create a branch, make a change, share a preview, and publish.
-## Open the editor
+Use the editor to write and publish documentation in your browser. The editor uses a docs-as-code workflow with all your changes backed by Git. Your work saves as commits in your repository and the editor manages Git operations for you.
-Open the editor from the [Editor](https://app.mintlify.com/editor) tab in your Mintlify dashboard. Any member of your organization can open the editor, but what you can do inside depends on your [role](/dashboard/roles). Admins and editors can edit and publish, and viewers can browse content and leave [comments](/editor/comments) or [suggestions](/editor/suggestions).
+The editor loads by default when you open your [dashboard](https://app.mintlify.com). Anyone in your organization can open it, but certain actions depend on your [role](/dashboard/roles). Admins and editors can edit and publish. Viewers can browse content and leave [comments and suggestions](/editor/collaborate).
## How the editor works
-**Changes save automatically.** As you type, the editor saves your work. Your changes persist across tabs, devices, and network interruptions. Changes only go live when you publish them.
+**Changes save automatically, but saving is separate from publishing.** As you type, the editor stores your work. Your changes persist across tabs, devices, and network interruptions. For any changes to reach your live site, you must [publish](/editor/publish) them.
-**Git stays in sync.** When someone else pushes changes to your repository from outside the editor, those changes appear in the editor automatically. You don't need to pull or refresh. The editor merges non-conflicting changes and highlights anything that needs your attention.
+**Publishing writes to Git.** When you publish, the editor commits your changes to your repository. If you publish to your deployment branch, this updates your live site immediately. On a feature branch, you can choose whether publishing updates your live site immediately or opens a pull request for review.
-
- If the editor ever appears out of sync with your repository, use [Reset editor](/editor/settings#reset-editor) to force a resync from Git. For example, the file tree is empty or shows `Unable to find docs.json` even though the file is present on your deployment branch.
-
+**Git stays in sync.** When someone pushes to your repository, those changes appear automatically. You don't need to pull or refresh. The editor merges non-conflicting changes and flags anything that needs your attention.
-**Publishing writes to Git.** When you publish, the editor commits your changes to your repository. On a deployment branch, this updates your live site immediately. On a feature branch, it creates a pull request.
+**Your team edits together.** Multiple people can edit the same page at once, with live cursors showing who is working where. Comments and suggestions are visible to everyone.
-**Your team edits together.** Multiple people can edit the same page simultaneously. Live cursors show who is editing and where.
+
+ If the editor ever appears out of sync with your repository, use [Reset editor](/editor/settings#reset-editor) to force a resync. For example, an empty file tree or the error `Unable to find docs.json` appears when the file is present on your deployment branch.
+
-## The editor layout
+## Editor layout
- 
- 
+ 
+ 
-- **Top bar**: Use the top bar to control what branch you work on, access the agent, preview, and publish changes.
-- **Navigation sidebar**: Select a page to edit, create new pages, and manage the site structure.
-
-## Explore the editor
-
-
- How branches and protection rules determine what happens when you publish, and how to manage the pull request review process.
-
-
-
- Leave feedback, ask questions, and discuss changes with your team.
-
-
-
- Propose changes that teammates can review, accept, or reject.
-
-
-
- Edit pages, search your content, modify settings, and configure your site from a chat interface.
-
-
-
- Add new and update existing pages.
-
-
-
- Reorder pages and manage site structure.
-
-
-
- Preview your site in real time as you edit without waiting for a build.
-
-
-
- Configure your site's branding, colors, and features.
-
-
-
- Configure AI instructions and publishing defaults for your deployment.
-
-
-
- Understand the Git concepts behind the editor: branches, commits, pull requests, and merges.
-
-
-
- Save time with keyboard shortcuts.
-
+* **Top bar**: Use the top bar to control what branch you work on, access the agent, preview, and publish changes.
+* **Sidebar**: Use the sidebar to select pages to edit, create new pages, and manage your site structure.
+ * **Home**: The file tree for your project. Pages in **Personal** are private to you. Pages in **Workspace** are public to your organization.
+ * **Publishing**: The navigation structure for your site. Organize pages as you want them to appear in your site.
+
+## Visual and source mode
+
+**Visual mode** renders your page as you type. Press / to open the component menu and insert components.
+
+**Source mode** gives you direct access to the MDX. Use it for precise control over component properties and frontmatter.
+
+Both modes edit the same file. Switch between them with Cmd + Shift + S (macOS) or Ctrl + Shift + S (Windows).
+
+For the components you can insert, see [Components](/components). For MDX syntax, see [Format text](/create/text) and [Format code](/create/code).
+
+## Git concepts
+
+Understanding some Git concepts helps you get the most from the editor.
+
+
+
+ A saved snapshot of your changes at a point in time, with a message describing what changed. Publishing creates a commit.
+
+
+ A separate line of work. Your live site builds from a **deployment branch**, usually `main`. Other branches—sometimes called **feature branches**—let you work without affecting your live site. Nothing on a feature branch goes live until you merge it.
+
+
+ A proposal to merge one branch into another, so your team can review changes before they go live. Your team reviews and merges pull requests in GitHub, GitLab, or Bitbucket, or [from the editor](/editor/review).
+
+
+ Combining changes from one branch into another. Merging into your deployment branch publishes those changes.
+
+
+ Two branches with incompatible changes to the same lines. The editor prompts you to choose which version to keep in order to resolve conflicts before merging.
+
+
+ A comparison between two versions of a file. The editor shows a diff of your pending changes before you publish.
+
+
+
+| Action in the editor | Git operation |
+|---|---|
+| Edit a page | Saves automatically. No commit yet. |
+| Publish on your deployment branch | `git commit` and `git push`. Triggers a deployment. |
+| Save in branch | `git commit` to the current feature branch. |
+| Create pull request | `git push` and opens a pull request against your deployment branch. |
+| Merge and publish | Merges the pull request and triggers a deployment. |
+| Create a branch | `git checkout -b ` |
+| Switch branches | `git checkout ` |
+| External push or CLI update | Incoming changes sync into the editor using a three-way merge. |
diff --git a/editor/keyboard-shortcuts.mdx b/editor/keyboard-shortcuts.mdx
index f5dcf76f5..4d05cb5ff 100644
--- a/editor/keyboard-shortcuts.mdx
+++ b/editor/keyboard-shortcuts.mdx
@@ -15,9 +15,7 @@ These shortcuts work regardless of which mode you're in.
| **Search files and content** | Cmd + K | Ctrl + K |
| **Toggle AI assistant** (when not editing text) | Cmd + I | Ctrl + I |
| **Switch between visual and source mode** | Cmd + Shift + S | Ctrl + Shift + S |
-| **Toggle diff view** | Cmd + Shift + D | Ctrl + Shift + D |
-| **Switch between Navigation and Files tree** | Cmd + Shift + F | Ctrl + Shift + F |
-| **Hide/show sidebar** | Cmd + \\ | Ctrl + \\ |
+| **Show all files** (including dotfiles and non-content files) | Cmd + Shift + . | Ctrl + Shift + . |
## Visual mode
@@ -44,6 +42,8 @@ Use these shortcuts when editing in visual mode.
| **Heading 2** | Cmd + Option + 2 | Ctrl + Alt + 2 |
| **Heading 3** | Cmd + Option + 3 | Ctrl + Alt + 3 |
| **Heading 4** | Cmd + Option + 4 | Ctrl + Alt + 4 |
+| **Heading 5** | Cmd + Option + 5 | Ctrl + Alt + 5 |
+| **Heading 6** | Cmd + Option + 6 | Ctrl + Alt + 6 |
### Lists and blocks
@@ -78,7 +78,7 @@ The editor automatically converts certain character sequences into typographic s
## Source mode
-Source mode uses the Monaco editor, which supports standard VS Code keyboard shortcuts.
+Source mode uses CodeMirror. Most common code editor shortcuts work, along with the ones below.
### Search and navigation
@@ -91,7 +91,11 @@ Source mode uses the Monaco editor, which supports standard VS Code keyboard sho
| Command | macOS | Windows |
| :--- | :--- | :--- |
+| **Bold** (wraps in `**`) | Cmd + B | Ctrl + B |
+| **Italic** (wraps in `_`) | Cmd + I | Ctrl + I |
| **Toggle comment** | Cmd + / | Ctrl + / |
+| **Fold all** | Cmd + Option + Shift + [ | Ctrl + Alt + Shift + [ |
+| **Unfold all** | Cmd + Option + Shift + ] | Ctrl + Alt + Shift + ] |
| **Indent line** | Tab | Tab |
| **Outdent line** | Shift + Tab | Shift + Tab |
| **Move line up** | Option + ↑ | Alt + ↑ |
diff --git a/editor/live-preview.mdx b/editor/live-preview.mdx
deleted file mode 100644
index 1f9edfafb..000000000
--- a/editor/live-preview.mdx
+++ /dev/null
@@ -1,53 +0,0 @@
----
-title: "Live preview"
-description: "Preview your site in real time as you edit, with continuous updates that render content, navigation, and configuration changes instantly."
-keywords: ["editor", "preview", "live preview"]
----
-
-Preview your site while you edit. Live previews render pages exactly as they look when published, and update as you make changes to content, navigation, and configuration.
-
-## Open live preview
-
-Click the 
- 
-
-
-## Edit site settings in live preview
-
-Edit your site settings in the live preview to see how they affect the rendered content.
-
-1. Open the live preview in the editor.
-2. Click **Site settings** in the preview toolbar.
-3. Select a configuration section and edit the settings.
-
-If you set the live preview to open in a new tab, the preview site settings menu is unavailable. Disable **Open live preview in new tab** in [editor settings](/editor/settings) to use the site settings menu.
-
-## Ask the agent in live preview
-
-Click **Ask agent** in the preview toolbar to open the [editor agent](/editor/agent) beside the live preview. Only editors and admins can use the agent in live previews.
-
-
- Live preview works for public sites and sites protected by Mintlify authentication.
-
-
-## Live preview versus preview deployments
-
-| | Live preview | Preview deployment |
-|---|---|---|
-| **Speed** | Instant | Requires a build |
-| **Access** | Local URL | Shareable URL |
-| **Use when** | Reviewing changes while editing | Sharing with your team for review |
-| **Availability** | While the editor is open | As long as the branch exists |
-
-Use live preview for immediate feedback while editing. When you need to share changes with your team or test on a different device, use a [preview deployment](/editor/branching-and-publishing#preview-your-changes).
diff --git a/editor/navigation.mdx b/editor/navigation.mdx
deleted file mode 100644
index 450e1bbbb..000000000
--- a/editor/navigation.mdx
+++ /dev/null
@@ -1,44 +0,0 @@
----
-title: "Organize navigation"
-description: "Reorder pages, add groups, and manage your documentation sidebar structure using drag-and-drop in the Mintlify web editor—no docs.json edits needed."
-keywords: ["editor", "navigation", "sidebar", "structure"]
----
-
-Use the navigation sidebar to organize your documentation. The editor syncs your changes to your repository when you publish. You don't need to edit `docs.json` manually.
-
-## Add navigation elements
-
-Click **Add new** at the bottom of the navigation tree to add a new element at the root level. To nest an element inside another, click the
- Some elements cannot nest inside other elements. For example, tabs cannot nest inside groups. The editor prevents you from creating invalid combinations.
-
-
-## Navigation elements
-
-Choose the right structure for your content:
-
-- **Pages**—Individual documentation files. The core building block of navigation.
-- **Groups**—Collapsible sections that cluster related pages together. Can nest within other groups.
-- **Tabs**—Top-level sections with horizontal navigation at the top of your site. Use tabs when you have distinct areas like API Reference and Guides.
-- **Anchors**—Persistent items at the top of your sidebar. Useful for quick access to external resources or top-level sections. Can be global to appear on every page.
-- **Dropdowns**—Expandable menus at the top of your sidebar. A lighter alternative to tabs for multiple related sections.
-- **Menus**—Dropdown navigation items within a tab for direct links to specific pages.
-- **Products**—A switcher for multiple distinct product documentation sets, each with its own navigation structure.
-- **Versions**—A switcher for multiple simultaneous documentation versions.
-- **Languages**—A switcher for documentation in multiple languages.
-
-## Configure elements
-
-Hover over any navigation element and click the gear icon to set:
-
-- **Title**: The label shown in the sidebar.
-- **Icon**: A visual marker next to the label.
-- **Tag**: A badge like "NEW" or "BETA" to highlight the item.
-
diff --git a/editor/pages.mdx b/editor/pages.mdx
index cd40b1fa8..9be78797f 100644
--- a/editor/pages.mdx
+++ b/editor/pages.mdx
@@ -1,172 +1,70 @@
---
title: "Create and edit pages"
-description: "Create pages, edit content, upload images and video, and manage files in the Mintlify web editor with rich-text editing and search across your content."
-keywords: ["editor", "content", "pages", "files", "create", "edit", "version history", "media", "images", "video", "task lists", "private pages"]
+sidebarTitle: "Edit content"
+description: "Create pages, edit content, add media, organize your navigation, and recover earlier versions of a page in the editor."
+keywords: ["editor", "content", "pages", "navigation", "version history", "media", "images", "private pages"]
---
-## Navigate files
+## Home and Publishing
-The left panel has two views: **Navigation** and **Files**.
+The editor workspace is split into two tabs: **Home** and **Publishing**.
-**Navigation** shows your sidebar structure as visitors see it. Click a page to open it.
+**Home** is your workspace. It shows the content files in your repository, including your private pages, whether or not they appear on your published site.
-**Files** shows the full file tree of your repository, including files that aren't in your navigation. Click any file to open it.
+**Publishing** is your published site. It shows the navigation your visitors see, along with your site settings.
-To switch between views, click the 
- 
-
+- **Groups**: Collapsible sections that cluster related pages. Can nest inside other groups.
+- **Tabs**: Top-level sections with horizontal navigation. Use these for distinct areas like API reference and guides.
+- **Anchors**: Persistent items at the top of your sidebar. Useful for external resources. Can be global, appearing on every page.
+- **Dropdowns**: Expandable menus at the top of your sidebar. A lighter alternative to tabs.
+- **Menus**: Dropdown items within a tab that link directly to specific pages.
+- **Products**: A switcher for multiple product documentation sets, each with its own navigation.
+- **Versions**: A switcher for multiple simultaneous documentation versions.
+- **Languages**: A switcher for documentation in multiple languages.
-### Table of contents
+
+ Some elements can't nest inside others. Tabs can't nest inside groups, for example. The editor prevents invalid combinations.
+
-In visual mode, the editor shows a minimap on the right side of the page that reflects the heading structure of your document. Hover over the minimap to expand it into a full table of contents. Click any heading to scroll to that section.
+To change a page's title, slug, description, or layout, open its settings from the navigation tree. See [Pages](/organize/pages) for more information on specific settings.
-### Code block options
+## Version history
-When editing a code block in visual mode, you can:
+Version history lets you review and restore earlier saved versions of a page. It isn't available for `docs.json`.
-- **Highlight or focus lines**: Select text within the code block, then use the toolbar that appears to mark lines as highlighted or focused. Highlighting visually emphasizes lines. Focusing lines dims everything else.
-- **Mark diff lines**: Select lines and use the toolbar to mark them as additions (`+`) or removals (`-`).
-- **Wrap**: Toggle line wrapping in the code block settings.
-- **Expandable**: Make the code block collapsible so readers can expand it on demand.
+Viewers can review and compare saved versions of private pages. Editors and admins can restore them.
-## Manage pages
+The editor records a new entry whenever content differs from the latest recorded version. Version history is branch-scoped. Only the current branch's version history is available.
-- **Move**: Drag and drop pages to reorder them in navigation.
-- **Rename**: Right-click a page and select **Rename**.
-- **Duplicate**: Right-click a page and select **Duplicate**.
-- **Delete**: Right-click a page and select **Delete**. The editor removes the page from navigation automatically.
+To view version history, click
- You can't move workspace content back to the **Private** section.
+ You can't move workspace content back to the **Private** section. Making a private page public is a one-way change.
-
-### Pages deleted via Git
-
-If a teammate deletes a page through Git while you have it open, the editor enters read-only mode and shows a banner. The editor preserves your content so you can copy it before navigating away.
-
-## Configure pages
-
-Hover over a page and click the gear icon, or right-click and select **Settings**, to configure:
-
-- **Title**, **Slug**, and **Sidebar title**: Control how the page appears in navigation and its URL.
-- **Description** and **Keywords**: Improve search and SEO.
-- **Layout**: Choose from standard, wide, centered, or custom.
-
-For details on each setting, see [Pages](/organize/pages).
-
-## Add media
-
-### Images and videos
-
-Type /image to upload a new image or select an existing one from your repository. Type /video to upload or select a video.
-
-You can also drag and drop files from your computer directly onto a page. In visual mode, the file inserts inline. In source mode, the editor inserts the file path at your cursor position. Images save to your `images/` folder and videos to `videos/`.
-
-To reuse media that already lives in your project, drag an image or video file from the navigation tree onto the page. The editor embeds the asset inline.
-
-### Light and dark image variants
-
-After inserting an image in visual mode, hover over it to reveal the image toolbar. Use **Light/dark variants** to upload separate images for light and dark mode.
-
-### Embed external media
-
-Type /embed and paste a YouTube, Loom, or Vimeo URL. The editor detects the provider and generates the iframe. Searching the slash menu for `youtube`, `yt`, `loom`, or `vimeo` also surfaces the **Embed** command.
-
-For other embeds, type /embed and toggle **Manual embed** to write custom HTML.
-
-For more on formatting images and using the Frame component, see [Images and embeds](/create/image-embeds).
diff --git a/editor/publish.mdx b/editor/publish.mdx
new file mode 100644
index 000000000..b287755eb
--- /dev/null
+++ b/editor/publish.mdx
@@ -0,0 +1,72 @@
+---
+title: "Publish changes"
+sidebarTitle: "Publish"
+description: "Publish changes from the editor to your live site. Branches and protection rules determine what happens when you publish."
+keywords: ["publish", "branch", "git", "commit", "conflicts", "deploy", "pull request"]
+---
+
+Your changes save automatically as you edit, but they only reach your live site when you publish them. What happens when you publish depends on which branch you work on and whether that branch requires pull requests.
+
+
+ If you don't see a branch selector or a **Publish** button, your deployment has [auto publish](#auto-publish) turned on and your edits go live automatically.
+
+
+## Pending changes
+
+The editor tracks the following as pending changes:
+
+- Content edits in pages
+- New or deleted pages
+- Navigation structure changes
+- Media uploads
+- Configuration updates
+
+If there are no pending changes, the editor disables the publish and save actions.
+
+## What happens when you publish
+
+| Branch type | Branch protection | Available actions |
+| --- | --- | --- |
+| Deployment branch | None | **Publish** directly to your live site |
+| Deployment branch | Pull requests required | **Create branch** to move changes to a new branch |
+| Feature branch | None | **Save in branch**, **Create pull request** |
+| Feature branch | Pull requests required | **Save in branch**, **Create pull request** |
+
+- **Publish**: Commits and deploys your changes to your live site immediately.
+- **Save in branch**: Commits your changes to the feature branch without merging to your deployment branch.
+- **Create branch**: Moves your pending changes to a new feature branch when you're on a protected deployment branch.
+- **Create pull request**: Opens a pull request targeting your deployment branch.
+
+Only one publish can happen at a time per branch. If a teammate publishes to the same branch, wait for their publish to complete before trying again.
+
+
+ Your live site updates after Mintlify builds and deploys your changes. This typically takes 30 seconds to a few minutes. Check the deployment status on your [dashboard](https://app.mintlify.com).
+
+
+## When to use a branch
+
+Edit directly on your deployment branch if you do not use a Git-based workflow. Create a branch if each change goes through review before it reaches your live site.
+
+To create a branch, click the branch name in the editor toolbar, select **Create new branch**, enter a name, then click **Create branch**.
+
+
+ Creating or switching branches while you have unpublished changes prompts you to bring those changes with you or leave them behind. Changes you leave behind stay on the original branch.
+
+
+## Resolve conflicts
+
+Conflicts occur when your branch and the deployment branch have incompatible changes to the same files. For example, when you and a teammate edit the same lines or move a file to different locations.
+
+When someone pushes to your repository from outside the editor, the editor applies non-overlapping changes automatically. If a remote change and your edit affect the same part of a page, the editor highlights the conflict.
+
+The editor displays a warning when conflicts block publishing. Follow the prompts to choose which version of each conflicting section to keep.
+
+## Commit signing
+
+Sign commits with your GitHub account by authorizing it in your [account settings](https://app.mintlify.com/settings/account). Without authorization, the Mintlify GitHub App signs commits made in the editor.
+
+## Auto publish
+
+If your deployment has [auto publish](/editor/settings#main-branch-autocommits) turned on, the editor commits to your deployment branch shortly after you stop typing. The branch selector and **Publish** button are hidden. There is no pending state and no review step.
+
+Edits on feature branches created from the editor commit automatically either way, but they never publish unless you merge them into your deployment branch.
diff --git a/editor/review.mdx b/editor/review.mdx
new file mode 100644
index 000000000..567b0c0ba
--- /dev/null
+++ b/editor/review.mdx
@@ -0,0 +1,82 @@
+---
+title: "Review changes"
+sidebarTitle: "Review"
+description: "Preview changes before they go live, share them with your team, and approve and merge pull requests from the editor."
+keywords: ["review", "preview", "live preview", "pull request", "approve", "merge", "diff"]
+---
+
+Preview your changes before they reach your live site, then review and merge the pull request without leaving the editor.
+
+## Live preview
+
+Live preview renders your site as you edit, with no build step. Click the
+ Live preview is only available for public sites and sites protected by Mintlify authentication.
+
+
+## Preview deployments
+
+When you open a pull request from a feature branch, Mintlify builds a preview deployment: a temporary URL where your changes render exactly as they look when published. The preview rebuilds each time you save new changes to the branch. The URL format is `organization-branch-name.mintlify.site`.
+
+Preview URLs are publicly accessible by default. To restrict access to members of your Mintlify organization, enable preview authentication on the [Add-ons](https://app.mintlify.com/products/addons) page of your dashboard.
+
+## Which preview to use
+
+| Feature | Live preview | Preview deployment |
+|---|---|---|
+| **Speed** | Instant | Requires a build |
+| **Access** | Local URL | Shareable URL |
+| **Use when** | Reviewing changes while editing | Sharing with your team for review |
+| **Availability** | While the editor is open | As long as the branch exists |
+
+## Share an editor link
+
+To point a teammate at a specific page on a branch, copy the URL from your browser's address bar. Anyone with access to your Mintlify organization can open it in their own editor session.
+
+```text
+https://app.mintlify.com/{org}/{project}/editor/{branch}/~/{filepath}
+```
+
+For example: `https://app.mintlify.com/acme/docs/editor/main/~/guides/quickstart.mdx`
+
+## Review and merge pull requests
+
+When a pull request is open for the current branch, the publish menu shows a review panel with the number of changed files and current review status.
+
+After a reviewer approves, click **Merge and publish** to merge and deploy from the editor. The editor switches you back to your deployment branch after merging.
+
+### Approve from the editor
+
+For GitHub repositories, reviewers can approve open pull requests without leaving the editor. An **Approve pull request** button appears in the review panel if your account has permission to review it. The status updates to **Approved** and **Merge and publish** becomes available.
+
+If you use GitLab or Bitbucket, open the pull request in your Git provider to approve it.
+
+
+ Configure branch protection rules in your Git provider to require pull requests. See [About protected branches](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches) in the GitHub help or [Protected branches](https://docs.gitlab.com/user/project/repository/branches/protected/) in the GitLab help.
+
+
+### Compare changes before merging
+
+Click any changed file in the publish menu to open it in diff view against the published version. Visual mode shows a visual diff and source mode shows a text diff. Files that can't display a diff, such as images or deleted files, appear in the list but aren't clickable.
+
+[Hidden pages](/organize/hidden-pages) that appear in the branch diff are openable from the publish menu, even though they don't appear in your site navigation.
+
+### Pull request titles and descriptions
+
+If your organization requires pull requests, you can enter a title and description when you publish. If you leave either blank, the editor generates one listing the files you created, updated, moved, or deleted. To control how those are written, set [PR instructions](/editor/settings#pr-instructions).
+
+If your branch has open comment threads, Mintlify adds a summary of them to the pull request description. See [Collaborate](/editor/collaborate#comments).
+
+## Review an automation run
+
+When an [automation](/automations) opens a pull request, you can open the editor on the automation's branch:
+
+- From the **Automation Runs** page in your dashboard, click **Open in editor** on a completed run.
+- From a Slack notification, click the **View changes** link.
+
+Either entry point opens the editor on the automation's branch with the changed pages preselected in the publish menu. You can review the diff and merge or request changes without leaving the editor. The [agent](/editor/agent#continue-an-automation-run) opens alongside it with context on what the automation did.
diff --git a/editor/settings.mdx b/editor/settings.mdx
index 63bda28d5..4a590e6da 100644
--- a/editor/settings.mdx
+++ b/editor/settings.mdx
@@ -1,73 +1,22 @@
---
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."
-keywords: ["editor", "settings", "ai", "instructions", "publishing", "pull request", "merge", "lock branch"]
+sidebarTitle: "Settings"
+description: "Configure editor appearance, AI instructions, and publishing defaults to control how the Mintlify web editor looks and how it commits and merges changes."
+keywords: ["editor", "settings", "ai", "instructions", "publishing", "pull request", "merge", "appearance", "preferences"]
---
-The web editor has two layers of settings:
+The editor [settings page](https://app.mintlify.com/settings/deployment/editor) controls the appearance, publishing behavior, and agent behavior.
-- **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**: Personal preferences for how the editor looks and behaves. These apply only to you.
+- **Publishing**: Deployment-wide defaults for how the editor commits changes and opens pull requests. These apply to everyone who publishes.
+- **Chat**: Persistent instructions for the editor's AI agent.
+- **Danger zone**: Actions that can't be undone.
-You can configure both from the settings panel. To open it, click the ` for callouts.
-
-Keep instructions short and specific. The AI follows them on every request, so vague or contradictory rules degrade results.
-
-### Configure AI instructions
-
-1. Click the or components.
-- Do not add introductory filler like "In this guide" or "Let's explore".
-```
-
-Leave the field empty to remove your instructions.
-
-## Publishing settings
-
-You configure publishing settings per deployment, and they apply to everyone who publishes from the editor. They control how the editor generates, opens, and merges pull requests and commits.
-
-You need admin access to your Mintlify deployment to change publishing settings.
-
-### Lock the deployment branch
-
-To make your deployment branch (usually `main`) read-only in the editor, lock the deployment branch.
-
-Use this setting when your team wants all editor changes to create pull requests from feature branches.
+PR instructions guide the AI when it generates a pull request title and description. They apply whenever the editor opens a pull request on your behalf, including from **Create pull request** and **Merge and publish** flows.
-### Pull request instructions
-
-Pull request instructions guide the AI when it generates a pull request title and description. They apply whenever the editor opens a pull request on your behalf, including from **Create pull request** and **Merge and publish** flows.
-
-Use pull request instructions to standardize what reviewers see, for example:
+Use PR instructions to standardize what reviewers see, for example:
- Required sections like **Summary** and **Changes**.
- A description template that links to a tracking system.
@@ -82,58 +31,66 @@ Description: include a "## Summary" section (one sentence) and a
using its relative path.
```
-### Main branch autocommits
-
-When you enable main branch autocommits, the editor commits changes shortly after you stop typing.
-
-Use this setting when your team edits the deployment branch directly and wants updates to reach Git without a manual publish step. If you want to review changes before they publish to your site, do not use autocommits.
-
-Edits on feature branches created from the editor autocommit regardless of this setting. Changes on a feature branch never publish unless you merge them into your deployment branch.
+Instructions are limited to 20,000 characters.
-### Create pull requests as drafts by default
+## Main branch autocommits
-Turn this on to have the editor open every new pull request in draft state. You can't merge a draft pull request until you mark it ready for review. This is useful when:
+Main branch autocommits push changes to your main branch automatically, shortly after you stop typing. If you enable this setting, the editor **hides branches and the publish step entirely**. Changes go live with no review.
-- Your team requires a manual review pass before a pull request is open for approval.
-- You want to share preview URLs without signaling that the change is ready to merge.
-
-You can still mark a pull request as ready for review from your Git provider.
+
+ With main branch autocommits on, there is no pending state and no chance to review. Every edit reaches your live site shortly after you stop typing.
+
-### Default merge method
+## PR merge method
Choose how the editor merges pull requests when you click **Merge and publish**:
-- **Merge**: Creates a merge commit that preserves the full branch history.
+- **Merge**: Creates a merge commit that preserves the full branch history. This is the default.
- **Squash**: Combines all commits in the branch into a single commit on your deployment branch.
- **Rebase**: Replays each commit from the branch onto your deployment branch without a merge commit.
-The editor uses the selected method by default. If you pass an explicit merge method through the API or your Git provider's UI, that choice takes precedence.
+If you pass an explicit merge method through the API or your Git provider's UI, that choice takes precedence.
- Match your default merge method to your Git provider's branch protection settings. If your deployment branch only allows squash merges, set the default to **Squash** to avoid failed merges from the editor.
+ Match your merge method to your Git provider's branch protection settings. If your deployment branch only allows squash merges, set the method to **Squash** to avoid failed merges from the editor.
-## Danger zone
+## AI instructions
-The **Danger zone** section of the editor settings panel contains actions that can't be undone. Click the
- If you reset the editor, you discard any unpublished changes that you haven't committed to Git. If you have pending edits you want to keep, publish them first.
-
+Each teammate maintains their own instructions, scoped to their user account. Instructions are limited to 20,000 characters.
-To reset the editor:
+Add AI instructions when you find yourself repeating the same guidance in prompts, for example:
-1. Click the ` for callouts.
+
+Keep instructions short and specific. The AI follows them on every request, so vague or contradictory rules degrade results.
+
+Example:
+
+```text
+- Use second person ("you") and active voice.
+- Use sentence case for all headings.
+- Refer to the product as "Acme"—never "Acme Inc." or "the platform".
+- Wrap notes and warnings in or components.
+- Do not add introductory filler like "In this guide" or "Let's explore".
+```
-The editor reloads and pulls the latest state from your repository.
+Leave the field empty to remove your instructions.
-## Related
+## Reset editor
-- [Branching and publishing](/editor/branching-and-publishing)
-- [Configurations](/editor/configurations)
+**Reset editor** forces the editor to discard its local state and sync with your Git repository. Reset the editor if it gets stuck out of sync with your repo, for example if the file tree is empty or shows errors like `Unable to find docs.json`. This can happen even though the file exists on your deployment branch and your live site builds normally.
+
+
+ If you reset the editor, you discard any unpublished changes that you haven't committed to Git. If you have pending edits you want to keep, publish them first.
+
diff --git a/editor/suggestions.mdx b/editor/suggestions.mdx
deleted file mode 100644
index cf23291f1..000000000
--- a/editor/suggestions.mdx
+++ /dev/null
@@ -1,50 +0,0 @@
----
-title: "Suggest changes in the editor"
-sidebarTitle: "Suggestions"
-description: "Propose text changes as suggestions that teammates can review, accept, or reject in the editor without modifying the current page content."
-keywords: ["suggestions", "suggesting", "collaboration", "review"]
----
-
-Suggestions let you propose changes to text while preserving the current content. Teammates can review, accept, or reject your suggestions.
-
-Suggesting mode applies to page text. Editors and admins can accept or reject any suggestion, but viewers cannot. See [roles](/dashboard/roles) for details.
-
-Pending suggestions appear as highlighted text in the editor. The sidebar lists them alongside comments so reviewers can find them.
-
-## Make suggestions
-
-1. Highlight any text on the page.
-2. Click the
- [Viewers](/dashboard/roles) are always in suggesting mode. Suggesting mode activates automatically when a viewer opens the editor. The **Suggesting** pill is visible but not interactive for viewers, so they remain in suggesting mode. This lets viewers propose changes without directly editing content.
-
-
-
- 
- 
-
-
-## Accept a suggestion
-
-1. Click the highlighted suggestion text.
-2. Click the
- - **Branches v2 e historial de versiones:** Las ramas del editor ahora se respaldan con pull requests en borrador y guardan automáticamente los cambios en Git. Puedes renombrar o eliminar ramas, descartar cambios guardados automáticamente y mover cambios pendientes a una rama nueva. El menú de ramas se ordena por actividad reciente, usa nombres por usuario y muestra nombres `Draft
+ ### 生成的 `/_llms/` 链接返回 404
+
+
+**症状**：`llms.txt` 文件可以加载，但 `/_llms/` 下的链接返回 404 或缺少你的公开子路径。
+
+**原因**：公开子路径与在 Mintlify 中配置的基础路径不匹配，或者代理仅转发了 `llms.txt` 而没有转发其生成的索引路由。
+
+**解决方案**：
+
+- 在 Mintlify 控制台中将公开子路径设置为基础路径。仓库中同名的目录并不会配置基础路径。
+- 转发完整的 `
### 性能问题
From ceeb62b76bfe84759494be4f03ae3ff21932fa4f Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Wed, 26 Aug 2026 02:43:35 +0000
Subject: [PATCH 8/8] docs: sync with editor overhaul and split long sentence
in review page
---
.../config/vocabularies/Mintlify/accept.txt | 5 +-
changelog.mdx | 14 +-
deploy/authentication-setup.mdx | 2 +-
docs.json | 10 +-
editor/agent.mdx | 18 +-
editor/branching-and-publishing.mdx | 192 ------------
editor/collaborate.mdx | 66 +++++
editor/comments.mdx | 97 -------
editor/configurations.mdx | 198 -------------
editor/git-essentials.mdx | 72 -----
editor/index.mdx | 128 ++++----
editor/keyboard-shortcuts.mdx | 12 +-
editor/live-preview.mdx | 53 ----
editor/navigation.mdx | 44 ---
editor/pages.mdx | 182 +++---------
editor/publish.mdx | 72 +++++
editor/review.mdx | 82 ++++++
editor/settings.mdx | 145 ++++-----
editor/suggestions.mdx | 50 ----
es.json | 11 +-
es/changelog.mdx | 10 +-
es/cli/index.mdx | 1 +
es/cli/install.mdx | 12 +-
es/cli/mdx-extension.mdx | 169 +++++++++++
es/cli/preview.mdx | 4 +
es/deploy/authentication-setup.mdx | 2 +-
es/editor/agent.mdx | 70 ++---
es/editor/branching-and-publishing.mdx | 264 -----------------
es/editor/collaborate.mdx | 82 ++++++
es/editor/comments.mdx | 108 -------
es/editor/configurations.mdx | 274 ------------------
es/editor/git-essentials.mdx | 84 ------
es/editor/index.mdx | 124 ++++----
es/editor/keyboard-shortcuts.mdx | 70 +++--
es/editor/live-preview.mdx | 69 -----
es/editor/media.mdx | 100 -------
es/editor/navigation.mdx | 49 ----
es/editor/pages.mdx | 242 +++-------------
es/editor/publish.mdx | 124 ++++----
es/editor/review.mdx | 131 +++++++++
es/editor/settings.mdx | 201 +++++--------
es/editor/suggestions.mdx | 57 ----
es/reference/concepts.mdx | 2 +-
es/reference/glossary.mdx | 2 +-
fr.json | 11 +-
fr/changelog.mdx | 10 +-
fr/cli/index.mdx | 1 +
fr/cli/install.mdx | 12 +-
fr/cli/mdx-extension.mdx | 169 +++++++++++
fr/cli/preview.mdx | 4 +
fr/deploy/authentication-setup.mdx | 2 +-
fr/editor/agent.mdx | 70 ++---
fr/editor/branching-and-publishing.mdx | 264 -----------------
fr/editor/collaborate.mdx | 82 ++++++
fr/editor/comments.mdx | 108 -------
fr/editor/configurations.mdx | 274 ------------------
fr/editor/git-essentials.mdx | 84 ------
fr/editor/index.mdx | 124 ++++----
fr/editor/keyboard-shortcuts.mdx | 50 ++--
fr/editor/live-preview.mdx | 69 -----
fr/editor/media.mdx | 100 -------
fr/editor/navigation.mdx | 49 ----
fr/editor/pages.mdx | 242 +++-------------
fr/editor/publish.mdx | 124 ++++----
fr/editor/review.mdx | 131 +++++++++
fr/editor/settings.mdx | 201 +++++--------
fr/editor/suggestions.mdx | 57 ----
fr/reference/concepts.mdx | 2 +-
fr/reference/glossary.mdx | 2 +-
images/editor/editor-layout-dark.png | Bin 93361 -> 0 bytes
images/editor/editor-layout-light.png | Bin 92839 -> 0 bytes
images/editor/layout-dark.png | Bin 0 -> 146893 bytes
images/editor/layout-light.png | Bin 0 -> 145469 bytes
images/editor/live-preview-dark.png | Bin 21157 -> 0 bytes
images/editor/live-preview-light.png | Bin 21326 -> 0 bytes
images/editor/preview-url-dark.png | Bin 45757 -> 0 bytes
images/editor/preview-url-light.png | Bin 47072 -> 0 bytes
redirects.json | 140 ++++++++-
reference/concepts.mdx | 2 +-
reference/glossary.mdx | 2 +-
zh.json | 11 +-
zh/changelog.mdx | 8 +-
zh/cli/index.mdx | 1 +
zh/cli/install.mdx | 12 +-
zh/cli/mdx-extension.mdx | 169 +++++++++++
zh/cli/preview.mdx | 4 +
zh/deploy/authentication-setup.mdx | 2 +-
zh/editor/agent.mdx | 120 ++++----
zh/editor/branching-and-publishing.mdx | 224 --------------
zh/editor/collaborate.mdx | 129 +++------
zh/editor/comments.mdx | 108 -------
zh/editor/configurations.mdx | 168 -----------
zh/editor/git-essentials.mdx | 75 -----
zh/editor/index.mdx | 114 +++++---
zh/editor/keyboard-shortcuts.mdx | 115 +++++---
zh/editor/live-preview.mdx | 61 ----
zh/editor/media.mdx | 100 -------
zh/editor/navigation.mdx | 49 ----
zh/editor/pages.mdx | 190 +++---------
zh/editor/publish.mdx | 133 ++++-----
zh/editor/review.mdx | 131 +++++++++
zh/editor/settings.mdx | 196 +++++--------
zh/editor/suggestions.mdx | 57 ----
zh/reference/concepts.mdx | 2 +-
zh/reference/glossary.mdx | 2 +-
105 files changed, 2698 insertions(+), 5573 deletions(-)
delete mode 100644 editor/branching-and-publishing.mdx
create mode 100644 editor/collaborate.mdx
delete mode 100644 editor/comments.mdx
delete mode 100644 editor/configurations.mdx
delete mode 100644 editor/git-essentials.mdx
delete mode 100644 editor/live-preview.mdx
delete mode 100644 editor/navigation.mdx
create mode 100644 editor/publish.mdx
create mode 100644 editor/review.mdx
delete mode 100644 editor/suggestions.mdx
create mode 100644 es/cli/mdx-extension.mdx
delete mode 100644 es/editor/branching-and-publishing.mdx
create mode 100644 es/editor/collaborate.mdx
delete mode 100644 es/editor/comments.mdx
delete mode 100644 es/editor/configurations.mdx
delete mode 100644 es/editor/git-essentials.mdx
delete mode 100644 es/editor/live-preview.mdx
delete mode 100644 es/editor/media.mdx
delete mode 100644 es/editor/navigation.mdx
create mode 100644 es/editor/review.mdx
delete mode 100644 es/editor/suggestions.mdx
create mode 100644 fr/cli/mdx-extension.mdx
delete mode 100644 fr/editor/branching-and-publishing.mdx
create mode 100644 fr/editor/collaborate.mdx
delete mode 100644 fr/editor/comments.mdx
delete mode 100644 fr/editor/configurations.mdx
delete mode 100644 fr/editor/git-essentials.mdx
delete mode 100644 fr/editor/live-preview.mdx
delete mode 100644 fr/editor/media.mdx
delete mode 100644 fr/editor/navigation.mdx
create mode 100644 fr/editor/review.mdx
delete mode 100644 fr/editor/suggestions.mdx
delete mode 100644 images/editor/editor-layout-dark.png
delete mode 100644 images/editor/editor-layout-light.png
create mode 100644 images/editor/layout-dark.png
create mode 100644 images/editor/layout-light.png
delete mode 100644 images/editor/live-preview-dark.png
delete mode 100644 images/editor/live-preview-light.png
delete mode 100644 images/editor/preview-url-dark.png
delete mode 100644 images/editor/preview-url-light.png
create mode 100644 zh/cli/mdx-extension.mdx
delete mode 100644 zh/editor/branching-and-publishing.mdx
delete mode 100644 zh/editor/comments.mdx
delete mode 100644 zh/editor/configurations.mdx
delete mode 100644 zh/editor/git-essentials.mdx
delete mode 100644 zh/editor/live-preview.mdx
delete mode 100644 zh/editor/media.mdx
delete mode 100644 zh/editor/navigation.mdx
create mode 100644 zh/editor/review.mdx
delete mode 100644 zh/editor/suggestions.mdx
diff --git a/.vale/styles/config/vocabularies/Mintlify/accept.txt b/.vale/styles/config/vocabularies/Mintlify/accept.txt
index ed010ced0..6ffd1cc18 100644
--- a/.vale/styles/config/vocabularies/Mintlify/accept.txt
+++ b/.vale/styles/config/vocabularies/Mintlify/accept.txt
@@ -32,13 +32,13 @@ Atlassian
(?i)auth
Auth0
authed
-autocommit
+autocommit(s|ed|ing)?
autofocuses
(?i)autogenerat(e|ed|ing)?
(?i)automations?
(?i)automerge
(?i)autoplay
-autosave(s|d)?
+autosav(e|es|ed|ing)
AVIF
AWS
axios
@@ -148,6 +148,7 @@ DORA
(?i)drilldown
DRY
DynamoDB
+dotfile(s)?
EasyList
ECS
EdDSA
diff --git a/changelog.mdx b/changelog.mdx
index 25f7d0da3..fb9f88d1f 100644
--- a/changelog.mdx
+++ b/changelog.mdx
@@ -9,8 +9,8 @@ noindex: true
## Editor and collaboration
- - **Editor branches:** When you create a branch, the editor now creates a draft pull request and autosaves changes to Git. You can rename or delete branches, discard autosaved changes, and move pending changes to a new branch. The branch menu is ordered by recent activity, uses per-user branch names, and shows cleaner `Draft
-
-
-
-Copy the URL and send it to reviewers. The preview updates automatically each time you save to the branch.
-
-### Restrict access to previews
-
-Preview URLs are publicly accessible by default. To restrict access to members of your Mintlify organization, enable preview authentication in the [Add-ons](https://app.mintlify.com/products/addons) page of your dashboard.
-
-### Share editor links
-
-To invite a teammate to a specific page on a branch, copy the URL from your browser's address bar and share it. Anyone with access to your Mintlify organization can open the link directly in their editor session.
-
-The URL format is:
-
-```text
-https://app.mintlify.com/{org}/{project}/editor/{branch}/~/{filepath}
-```
-
-For example: `https://app.mintlify.com/acme/docs/editor/main/~/guides/quickstart.mdx`
-
-## Review and merge pull requests
-
-When a pull request is open for the current branch, the publish menu shows a review panel with:
-
-- The pull request title, description, and whether it is a draft.
-- The source and target branches.
-- The number of changed files.
-- The approval requirement on the deployment branch: **Approval required**, **Code owner required**, or no requirement.
-- The current review status: **Approved**, **Changes requested**, or **Awaiting review**.
-
-Click the pull request link to open it in GitHub, GitLab, or Bitbucket.
-
-After a reviewer approves a pull request, click **Merge and publish** to merge and deploy directly from the editor. The editor switches to your deployment branch after merging.
-
-### Approve pull requests from the editor
-
-For GitHub repositories, reviewers can approve open pull requests in the editor. When a pull request is open, an **Approve pull request** button appears in the review panel if your account has permission to review it. Click **Approve pull request** when the changes are ready to merge. The review status updates to **Approved** and the **Merge and publish** action becomes available.
-
-If you use GitLab or Bitbucket, open the pull request in your Git provider to approve it.
-
-
+
+
+
+All [roles](/dashboard/roles) can comment and reply, including viewers. Only editors and admins can resolve threads. Resolving a thread removes it from the sidebar and clears the highlight from the page.
+
+You can delete your own comments and admins can delete any comment. Deleting the first comment in a thread deletes the entire thread.
+
+Type `@` to mention a teammate. They must be a member of your organization and they receive an email notification.
+
+If your branch has an open pull request, Mintlify adds a summary of unresolved threads to the pull request description, with a link back to each comment. The summary updates as threads change.
+
+## Suggestions
+
+Suggestions propose a change while leaving the current content in place, so a teammate can accept or reject it.
+
+Editors and admins can accept or reject any suggestion. Viewers cannot.
+
+To make a suggestion, highlight text and click the
-
-
-
-## Reply to a comment
-
-To open a comment thread, click the highlighted text or click the thread in the comment sidebar. Type your reply and press Enter to submit.
-
-
-
-
-
-
-## Mention a teammate
-
-Type `@` in a comment or reply to mention a teammate. People must be a member of your organization for you to mention them.
-
-Mentioned teammates receive an email notification.
-
-## Ask the Mintlify agent
-
-Mention `@mintlify` in a comment, [suggestion](/editor/suggestions), or reply to ask the [editor agent](/editor/agent) a question about the current page. The agent runs asynchronously with the page, thread, and branch as context, then posts its answer as a new reply in the same thread.
-
-Use `@mintlify` mentions to ask questions like:
-
-- `@mintlify does this endpoint support pagination?`
-- `@mintlify is this the recommended way to configure webhooks?`
-- `@mintlify are there any pages that contradict this?`
-
-The agent runs in read-only mode when replying to comments. It can search your docs, read pages, fetch web content, and load skills, but it cannot edit content, create suggestions, or publish changes. To make changes, open the [editor agent](/editor/agent) directly.
-
-`@mintlify` mentions work on private pages for members who already have access. Each agent reply counts toward your editor agent usage.
-
-## Resolve a comment
-
-Editors and admins can resolve threads when a discussion is complete.
-
-Click the checkmark icon to resolve a thread. Resolving a thread removes it from the comment sidebar and clears the highlight from the page.
-
-
-
-
-
-
-## Delete a comment
-
-Click the trashcan icon beside a comment to delete it. Deleting the first comment in a thread deletes the entire thread.
-
-You can delete your own comments. Admins can delete any comment.
diff --git a/editor/configurations.mdx b/editor/configurations.mdx
deleted file mode 100644
index 5b3c41c3b..000000000
--- a/editor/configurations.mdx
+++ /dev/null
@@ -1,198 +0,0 @@
----
-title: "Configurations"
-description: "Edit site branding, appearance, navigation, and feature settings from the Configurations panel in the Mintlify web editor, with real-time team sync."
-keywords: ["editor", "configurations", "settings", "branding", "theme"]
-boost: 3
----
-
-Configure your site's branding, appearance, and features from the **Site configurations** panel in the web editor. Configuration changes sync in real time with other editors on the same branch, so your team always sees the latest settings.
-
-To open the panel, click the
-
-
-
-The panel groups settings into sections that map to the top-level properties in your [`docs.json`](/organize/settings).
-
-## General
-
-Set your site's identity and how it appears to visitors.
-
-- **Name**: The name of your project. Appears in browser tabs and search results.
-- **Description**: Brief overview of your project. Used for SEO and answer engine optimization (AEO).
-
-## Branding
-
-Upload the marks that identify your site.
-
-- **Logo**: Your brand logo. Upload PNG or JPG files. Set separate light and dark versions and an optional click-through URL. To use an SVG logo, add the file to your repository and reference its path in your [`docs.json`](/organize/settings-appearance#logos).
-- **Favicon**: Small icon that appears in browser tabs. Upload ICO, PNG, GIF, or JPG files. Set separate light and dark versions if needed.
-
-## Styling
-
-Control your site's visual identity and color scheme.
-
-- **Theme**: Choose a [theme](/customize/themes) for your site's overall appearance.
-- **Primary color**: The main accent color used throughout your site for links, buttons, and highlights.
-- **Light color**: Accent color used in dark mode. How themes apply this varies by theme.
-- **Dark color**: Accent color used in light mode. How themes apply this varies by theme.
-- **Background color**: Custom background colors for light and dark modes.
-- **Icon library**: Icon library used for all icon properties. Defaults to `fontawesome`.
-- **Strict appearance**: Lock the site to a single appearance mode and hide the theme toggle.
-- **Default appearance**: Whether your site loads in `system`, `light`, or `dark` mode by default.
-- **Background decoration**: Apply a visual style (`gradient`, `grid`, or `windows`) to your background.
-- **Background image**: Optional background image. Set a single image or separate light and dark versions.
-
-## Typography
-
-Replace default fonts with your brand's typography.
-
-- **Font family**: Any [Google Fonts](https://fonts.google.com/) family works out of the box. For a self-hosted font, provide a source URL and format (`woff` or `woff2`).
-- **Weight**: Typically `400` for regular and `700` for bold. Variable fonts support precise weights like `550`.
-- **Heading font**: Optional override applied to all headings (`h1` through `h6`).
-- **Body font**: Optional override applied to body text and the remainder of the page.
-
-## Navbar
-
-Add navigation elements to the top of your site.
-
-- **Primary button**: The main call-to-action in your header. Set the type, label, and destination URL.
-- **Navbar links**: Additional navigation links in your header. Each link includes text and a URL.
-
-## Footer
-
-Add links and social media handles to your site footer.
-
-- **Social links**: Profiles on platforms like GitHub, X, LinkedIn, Discord, YouTube, and Slack.
-- **Footer columns**: Enable to organize footer links into up to four columns with custom headings.
-
-## Banner
-
-Display an announcement bar across the top of every page.
-
-- **Content**: The banner text. Supports basic MDX formatting like links, bold, and italic. Custom components are not supported.
-- **Dismissible**: Show a dismiss button on the right side of the banner.
-- **Type**: Visual style. `info` uses the primary brand color, `warning` uses an amber background, and `critical` uses a red background. Defaults to `info`.
-- **Color**: Override the banner background color with a custom hex color. Set separate light and dark values for theme-aware colors.
-
-## Thumbnail
-
-Customize page thumbnails and social previews.
-
-- **Background**: Custom background image for thumbnails.
-- **Appearance**: Render thumbnails in `light` or `dark` mode. When unset, thumbnails are auto-generated from your theme colors.
-- **Font**: Custom font for text in thumbnails.
-
-## Content
-
-Customize how content appears on your site.
-
-- **Page eyebrow**: Show small labels preceding page titles. Choose `section` or `breadcrumbs`.
-- **Timestamps**: Show the date the content was last modified on all pages.
-- **LaTeX**: Load LaTeX (KaTeX) stylesheets for mathematical notation rendering.
-
-## Code blocks
-
-Configure syntax highlighting and code block behavior.
-
-- **Code block theme**: Match the site light/dark mode with `system`, always use a dark theme with `dark`, or pick a custom [Shiki](https://shiki.style/) theme.
-- **Custom code languages**: Register additional syntax highlighting languages.
-
-## Context menu
-
-Configure the quick actions surfaced in the page context menu.
-
-- **Options**: Multi-select dropdown of actions like `copy`, `view`, and opening the page in `chatgpt`, `claude`, `cursor`, and other AI assistants.
-- **Display**: Where to display the options. `header` (default) shows them in the top-of-page context menu; `toc` shows them in the table of contents sidebar.
-
-## Navigation
-
-Tune navigation behavior across your site.
-
-- **Drilldown**: Auto-navigate to the first page when a user clicks a navigation group.
-
-## Search
-
-Customize the search experience and feedback.
-
-- **Search placeholder**: The text that appears in the search box before users type. Default is `Search or ask`.
-- **Feedback**: Show thumbs-up and thumbs-down buttons or a "Suggest edits" link on every page.
-
-## API reference
-
-Document your API endpoints.
-
-- **OpenAPI specs**: Add OpenAPI specification files to generate API reference pages.
-- **AsyncAPI specs**: Add AsyncAPI specification files to generate API reference pages.
-- **MDX server**: Custom MDX server endpoints for the API playground.
-- **Playground display**: Show the interactive API playground, the simple API playground, or no API playground.
-- **Proxy server**: Enable or disable the proxy server for API requests.
-- **MDX schema**: Whether to render the schema section on API reference pages.
-
-## Redirects
-
-Use the **Redirects** section to add, edit, search, and remove redirects without manually editing your `docs.json` file. Redirects send users from old URLs to new ones, which is useful when you rename pages or restructure your site. For more information, see [Redirects](/create/redirects).
-
-Each redirect has the following fields:
-
-- **Source**: The path to redirect from, like `/old-path`. Supports wildcards.
-- **Destination**: The path to redirect to, like `/new-path`. Supports wildcards.
-- **Status**: The HTTP status code for the redirect.
- - `308`: Permanent redirect. Use this for content that has moved permanently. This is the default status.
- - `307`: Temporary redirect. Use this when the move is temporary.
-
-
-
-
-
-
-To add a redirect:
-
-1. Click **Add redirect**.
-2. Enter the source and destination.
-3. Click **Save**.
-
-To edit or remove an existing redirect, hover over the row and use the inline edit icon or the **X** to remove it.
-
-## SEO
-
-Configure metatags and indexing for search engines.
-
-- **Metatags**: Custom `` tags applied across your site. Add key-value pairs for tags like `og:image` or `twitter:card`.
-- **Indexing**: Choose whether to index hidden pages.
-
-## Analytics
-
-Connect analytics platforms to track visitor behavior. Supported providers include Amplitude, Mixpanel, Heap, Google Analytics, Google Tag Manager, PostHog, Plausible, Fathom, Segment, Hightouch, Hotjar, LogRocket, Microsoft Clarity, Intercom, Clearbit, and more.
-
-Each entry renders as an inline row. Use the **X** icon to remove an integration.
-
-## 404 page
-
-Customize the experience when a user lands on a missing page.
-
-- **Redirect to home**: When on, missing pages redirect to your home page. When off, the site shows a 404 page and you can customize the title and description below.
-- **Title**: Heading shown on the 404 page.
-- **Description**: Subheading shown on the 404 page.
-
-## Variables
-
-Define custom variables that can be re-used throughout your content. Each variable is a key-value pair. Use the **X** icon to remove a variable.
diff --git a/editor/git-essentials.mdx b/editor/git-essentials.mdx
deleted file mode 100644
index b4e809642..000000000
--- a/editor/git-essentials.mdx
+++ /dev/null
@@ -1,72 +0,0 @@
----
-title: "Git essentials for the editor"
-sidebarTitle: "Git essentials"
-description: "Understand the Git version control concepts behind the Mintlify editor, including branches, commits, pull requests, and merge workflows."
-keywords: ["git", "version control", "web editor", "branches", "commits", "pull requests", "PRs"]
----
-
-Git lets you control and track changes to files. It's the version control system behind branch-based workflows, where you manage content the same way you would any other codebase.
-
-The web editor handles Git operations for you. Understanding a few key concepts helps you get the most out of the editor and collaborate effectively with your team.
-
-## What Git does for your content
-
-Git tracks every change made to your content. It records what changed, who changed it, when they changed it, and why. This means you can:
-
-- See the full history of any page.
-- Undo changes by reverting to a previous version.
-- Work on updates without affecting your live site.
-- Review changes before they go live.
-
-Your repository is the collection of files and their history that makes up your site. The editor connects to this repository to sync and publish your content.
-
-## Key concepts
-
-These are the Git concepts you'll encounter most often when using the web editor.
-
-
-
+
+
-- **Top bar**: Use the top bar to control what branch you work on, access the agent, preview, and publish changes.
-- **Navigation sidebar**: Select a page to edit, create new pages, and manage the site structure.
-
-## Explore the editor
-
-
-
-
-
-## Edit site settings in live preview
-
-Edit your site settings in the live preview to see how they affect the rendered content.
-
-1. Open the live preview in the editor.
-2. Click **Site settings** in the preview toolbar.
-3. Select a configuration section and edit the settings.
-
-If you set the live preview to open in a new tab, the preview site settings menu is unavailable. Disable **Open live preview in new tab** in [editor settings](/editor/settings) to use the site settings menu.
-
-## Ask the agent in live preview
-
-Click **Ask agent** in the preview toolbar to open the [editor agent](/editor/agent) beside the live preview. Only editors and admins can use the agent in live previews.
-
-
-
-
+- **Groups**: Collapsible sections that cluster related pages. Can nest inside other groups.
+- **Tabs**: Top-level sections with horizontal navigation. Use these for distinct areas like API reference and guides.
+- **Anchors**: Persistent items at the top of your sidebar. Useful for external resources. Can be global, appearing on every page.
+- **Dropdowns**: Expandable menus at the top of your sidebar. A lighter alternative to tabs.
+- **Menus**: Dropdown items within a tab that link directly to specific pages.
+- **Products**: A switcher for multiple product documentation sets, each with its own navigation.
+- **Versions**: A switcher for multiple simultaneous documentation versions.
+- **Languages**: A switcher for documentation in multiple languages.
-### Table of contents
+
-
-
-
-## Accept a suggestion
-
-1. Click the highlighted suggestion text.
-2. Click the
@@ -236,7 +236,7 @@ noindex: true
## Mejoras del editor
- - **Borradores:** Trabaja en cambios sin publicar sin crear una rama ni usar comandos de Git. Consulta [Borradores](/es/editor/branching-and-publishing) para obtener más información.
+ - **Borradores:** Trabaja en cambios sin publicar sin crear una rama ni usar comandos de Git. Consulta [Borradores](/es/editor/publish) para obtener más información.
- **Bloquea la rama de despliegue:** El editor ahora te pide bloquear tu rama de despliegue si detecta protecciones de rama.
- **[Agente del editor](/es/editor) más rápido con mejor función de deshacer/rehacer:** Las actualizaciones del agente ahora se transmiten al instante, la navegación es más rápida y los cambios de contenido y del árbol de navegación se pueden deshacer y rehacer de forma limpia.
- **El estado de los encabezados plegables se mantiene por usuario:** Tus preferencias de secciones expandidas y colapsadas se conservan entre sesiones del editor.
@@ -1071,7 +1071,7 @@ noindex: true
- Se rediseñó la página de configuración del editor con un diseño mejorado y soporte de autoguardado.
- Las páginas generadas automáticamente a partir de especificaciones OpenAPI ahora aparecen en el editor web como entradas de solo lectura.
- - Soporte de video en la [vista previa en vivo](/es/editor/live-preview). Los archivos mp4, webm y mov incrustados ahora se renderizan correctamente durante el desarrollo local.
+ - Soporte de video en la [vista previa en vivo](/es/editor/review#live-preview). Los archivos mp4, webm y mov incrustados ahora se renderizan correctamente durante el desarrollo local.
- Las [automatizaciones](/es/automations) ahora se pueden deshabilitar y volver a habilitar desde el dashboard.
- Los análisis del asistente ahora muestran el uso desglosado por fuente (web vs API) en el dashboard.
- La búsqueda MCP autenticada ahora filtra correctamente los resultados según los grupos de autenticación del usuario.
@@ -1620,7 +1620,7 @@ Visualiza el feedback desglosado por páginas individuales en tu dashboard de [a
## Mejoras en el editor web
- * Se añadieron [enlaces de vista previa compartibles](/es/editor/branching-and-publishing#access-and-share-a-preview) en la barra de herramientas del editor.
+ * Se añadieron [enlaces de vista previa compartibles](/es/editor/review#preview-deployments) en la barra de herramientas del editor.
* Se actualizó el [flujo de publicación](/es/editor/publish) para permitir la publicación con un solo clic o la creación de solicitudes de extracción.
* Trabajar en el editor web ya no requiere que inicies sesión con GitHub.
diff --git a/es/cli/index.mdx b/es/cli/index.mdx
index aa840435f..579bffb0e 100644
--- a/es/cli/index.mdx
+++ b/es/cli/index.mdx
@@ -86,5 +86,6 @@ https://mcp.mintlify.com
- ## Formato
+
-En modo visual, seleccione texto en una página. Aparece una barra de herramientas flotante sobre la selección. Haga clic en **Add to agent** para enviar el texto seleccionado al agente como contexto.
+En el modo visual, seleccione un texto y haga clic en **Add to agent** en la barra de herramientas flotante para enviarlo al agente como contexto.
+ ## Soporte para editores
-Para resaltado de sintaxis y formato de código en archivos MDX, recomendamos usar las siguientes extensiones:
+Para resaltado de sintaxis, autocompletado y verificación de errores en archivos MDX, usa las siguientes extensiones:
-- **Cursor, Devin Desktop, VS Code**: [Extensión MDX para VS Code](https://marketplace.visualstudio.com/items?itemName=unifiedjs.vscode-mdx) y [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode)
-- **JetBrains**: [Plugin MDX para IntelliJ IDEA](https://plugins.jetbrains.com/plugin/14944-mdx) y [Prettier](https://prettier.io/docs/webstorm)
+- **Cursor, Devin Desktop, VS Code**: [Extensión Mintlify MDX](/es/cli/mdx-extension) y [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) para el formato.
+- **JetBrains**: [Plugin MDX para IntelliJ IDEA](https://plugins.jetbrains.com/plugin/14944-mdx) y [Prettier](https://prettier.io/docs/webstorm).
+
+También puedes formatear archivos MDX con [`mint format`](/es/cli/commands#mint-format).
## Solución de problemas
diff --git a/es/cli/mdx-extension.mdx b/es/cli/mdx-extension.mdx
new file mode 100644
index 000000000..cd1128c27
--- /dev/null
+++ b/es/cli/mdx-extension.mdx
@@ -0,0 +1,169 @@
+---
+title: "Extensión Mintlify MDX"
+description: "Instala la extensión Mintlify MDX para obtener autocompletado, diagnósticos en línea, documentación al pasar el cursor y una previsualización en el editor mientras escribes MDX localmente."
+keywords: ["Cursor", "MDX", "autocompletado", "diagnósticos", "IntelliSense", "previsualización", "editor"]
+---
+
+La extensión Mintlify MDX agrega compatibilidad de lenguaje para proyectos de Mintlify a VS Code, Cursor, Devin Desktop y otros editores compatibles con la API de extensiones de VS Code. La extensión conoce todos los componentes y propiedades integrados, por lo que obtienes autocompletado mientras escribes, y reporta componentes desconocidos, propiedades inválidas e importaciones de snippets sin resolver.
+
+La extensión también ejecuta una previsualización en vivo dentro de tu editor, para que puedas escribir y ver el resultado renderizado sin cambiar a un navegador.
+
+
+ Usa la previsualización en el editor mientras escribes páginas individuales, y [`mint dev`](/es/cli/preview) en un navegador cuando quieras probar la navegación, la búsqueda o la autenticación en todo tu sitio.
+
+
+
+
+ La extensión resuelve los componentes en relación con la raíz de tu documentación. Ejecuta **Mintlify: Show detected docs root** para confirmar que encontró el archivo `docs.json` correcto. Si la raíz es incorrecta o falta, abre la carpeta que contiene tu archivo `docs.json` como tu espacio de trabajo.
+
+ Si la raíz es correcta, ejecuta **Mintlify: Restart language server**.
+
+
+ Es probable que otra extensión MDX también esté activa. Abre la vista de Extensiones, busca `mdx` y desactiva cualquier otra extensión MDX en este espacio de trabajo.
+
+
+ Abre el canal de salida **Mintlify Preview** para ver el error de `mint dev`.
+
+ - `could not run "mint dev --no-open"`: La CLI no está instalada. Instálala con `npm i -g mint`.
+ - `Trust the workspace first`: Confía en el espacio de trabajo a través de **Manage Workspace Trust**.
+ - `no docs.json found above this file`: Abre la carpeta que contiene tu archivo `docs.json` como tu espacio de trabajo.
+ - `Invalid docs.json`: Ejecuta [`mint validate`](/es/cli/commands#mint-validate) para encontrar el error de configuración.
+
+
+ Las rutas de importación absolutas se resuelven desde la raíz de tu documentación, no desde tu archivo. Confirma que la ruta coincide con la ubicación del archivo de snippet en relación con tu archivo `docs.json`, y que la raíz detectada es correcta.
+
+
diff --git a/es/cli/preview.mdx b/es/cli/preview.mdx
index d8dd74d91..33f5481e5 100644
--- a/es/cli/preview.mdx
+++ b/es/cli/preview.mdx
@@ -35,6 +35,10 @@ Para generar una previsualización sin instalar la CLI globalmente, ejecuta:
npx mint dev
```
+
+ Si escribes en VS Code o Cursor, la [extensión Mintlify MDX](/es/cli/mdx-extension) ejecuta esta previsualización en un panel junto a tu editor y la desplaza para coincidir con la página que estás editando.
+
+
-Haga clic en el icono del clip en el cuadro de chat, o arrastre y suelte archivos en el panel. El agente lee los archivos adjuntos como contexto para su solicitud.
+Haga clic en el icono del clip en el cuadro de chat o arrastre y suelte archivos en el panel. El agente lee los archivos adjuntos como contexto para su solicitud.
Tipos de archivo admitidos:
- **Imágenes**: JPG, PNG, GIF, WebP, SVG
- **Documentos**: PDF
- **Código y texto**: `.js`, `.ts`, `.jsx`, `.tsx`, `.mdx`, `.md`, `.json`, `.yaml`, `.html`, `.css`, Python, Go, Rust, Ruby, Java, Swift, C, C++, SQL, scripts de shell y más
-Tamaño máximo: 5 MB por archivo, excepto los archivos SVG, que están limitados a 256 KB. Máximo: 10 archivos por mensaje.
+Tamaño máximo: 5 MB por archivo, salvo los archivos SVG, limitados a 256 KB. Máximo: 10 archivos por mensaje.
Mintlify elimina los scripts y otro contenido activo de los archivos SVG antes de que el agente los lea.
@@ -59,26 +49,26 @@ Mintlify elimina los scripts y otro contenido activo de los archivos SVG antes d
+ ## Requisitos previos
+
+
+- VS Code 1.85.0 o más reciente
+- Un directorio de documentación con un archivo `docs.json` válido
+- La [CLI de Mintlify](/es/cli/install), solo para la previsualización en el editor
+
+
+ ## Instalar la extensión
+
+
+Instala desde la línea de comandos:
+
+```bash
+code --install-extension mintlify.mintlify-snippets
+```
+
+O instala desde tu editor:
+
+1. Abre la vista de Extensiones.
+2. Busca `@id:mintlify.mintlify-snippets`.
+3. Haz clic en **Install**.
+
+También puedes instalarla desde el [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=mintlify.mintlify-snippets).
+
+La extensión se activa cuando abres un archivo `.mdx` o un espacio de trabajo que contiene un archivo `docs.json`.
+
+
+ ## Autocompletado
+
+
+Escribe `<` para ver todos los componentes integrados. El autocompletado sugiere las propiedades y los valores de los componentes dentro de las etiquetas.
+
+La extensión sugiere los componentes que importas desde [snippets reutilizables](/es/create/reusable-snippets) junto con los integrados.
+
+
+ ## Diagnósticos
+
+
+La extensión reporta problemas en el panel de Problemas y los subraya en tu archivo mientras escribes:
+
+- Componentes desconocidos.
+- Propiedades desconocidas o duplicadas.
+- Valores inválidos para propiedades enumeradas.
+- Propiedades requeridas faltantes.
+- Etiquetas sin cerrar o mal emparejadas.
+- Importaciones de snippets sin resolver.
+
+Estas clases de errores causan fallos de compilación, así que corrígelos mientras escribes para evitar despliegues fallidos.
+
+Para desactivar los diagnósticos, establece `mintlify.diagnostics.enabled` en `false`.
+
+
+ ## Documentación al pasar el cursor
+
+
+Pasa el cursor sobre un componente o una propiedad para ver qué hace y un enlace a su página en la documentación de Mintlify. Al pasar el cursor sobre un componente de snippet se previsualiza el contenido del archivo de snippet.
+
+
+ ## Ir a la definición
+
+
+Mantén presionado CMD (macOS) o CTRL (Windows) y haz clic para navegar a la definición de:
+
+- Componentes de snippet.
+- Rutas de importación.
+- Atributos `href` y `src` que apuntan a páginas locales.
+
+La extensión encuentra la raíz de tu documentación subiendo desde el archivo abierto hasta encontrar `docs.json`, por lo que las importaciones absolutas como `/snippets/example.mdx` se resuelven correctamente. El proyecto detectado aparece en la barra de estado. Para comprobar qué raíz está usando la extensión, ejecuta **Mintlify: Show detected docs root** desde la paleta de comandos.
+
+
+ ## Validación de configuración
+
+
+La extensión valida `docs.json` contra el [esquema de Mintlify](https://mintlify.com/docs.json).
+
+
+ ## Previsualización en tu editor
+
+
+Abre un archivo `.mdx` y selecciona el icono de previsualización en la barra de título del editor, o haz clic derecho en el archivo y selecciona **Preview Mintlify**. Un panel de previsualización se abre junto a tu editor y renderiza la página.
+
+Las previsualizaciones en el editor requieren la [CLI de Mintlify](/es/cli/install). La URL del servidor en ejecución aparece en la barra de estado. Selecciónala para detener el servidor, o ejecuta **Mintlify: Stop preview server**.
+
+Para ver la salida del proceso `mint dev` subyacente, abre el canal de salida **Mintlify Preview**.
+
+
+ ## Envolver contenido en componentes
+
+
+La extensión incluye snippets que envuelven el texto seleccionado en un componente, en lugar de insertar un componente vacío para que lo completes.
+
+Para usarlos, selecciona el contenido que quieres envolver, luego ejecuta **Snippets: Surround With** desde la paleta de comandos y elige un componente. Hay snippets disponibles para `AccordionGroup`, `CardGroup`, `CodeGroup`, `Expandable`, `Frame`, `RequestExample`, `ResponseExample` y bloques de código delimitados.
+
+
+ ## Configuración
+
+
+| Configuración | Valor predeterminado | Descripción |
+| --- | --- | --- |
+| `mintlify.diagnostics.enabled` | `true` | Reporta componentes desconocidos, propiedades desconocidas, propiedades requeridas faltantes e importaciones de snippets sin resolver. |
+| `mintlify.warnAboutConflictingExtensions` | `true` | Advierte cuando tienes otra extensión MDX instalada junto a la extensión Mintlify MDX. |
+| `mintlify.preview.command` | `mint dev --no-open` | Comando usado para iniciar el servidor de previsualización, ejecutado desde la raíz de tu proyecto. |
+| `mintlify.preview.followScroll` | `true` | Desplaza la previsualización hasta el encabezado más cercano a la parte superior de tu editor. |
+
+`mintlify.preview.command` es una configuración de usuario, por lo que un espacio de trabajo no puede sobrescribirla. Esto evita que un repositorio clonado ejecute un comando arbitrario en tu máquina cuando abres una previsualización.
+
+
+ ## Comandos
+
+
+Ejecútalos desde la paleta de comandos:
+
+| Comando | Descripción |
+| --- | --- |
+| **Mintlify: Preview Mintlify** | Abre el panel de previsualización para el archivo actual. |
+| **Mintlify: Stop preview server** | Detiene el servidor de previsualización en ejecución. |
+| **Mintlify: Show detected docs root** | Muestra qué archivo `docs.json` resolvió la extensión. |
+| **Mintlify: Open component docs** | Abre la documentación del componente en tu cursor. |
+| **Mintlify: Restart language server** | Reinicia el servidor de lenguaje. |
+
+
+ ## Extensiones en conflicto
+
+
+Otras extensiones MDX proporcionan su propio resaltado de sintaxis y funciones de lenguaje para archivos `.mdx`, que entran en conflicto con esta extensión. Desactiva otras extensiones MDX para evitar sugerencias duplicadas y resaltado inconsistente.
+
+Para el formato de código, usa [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) junto con esta extensión o ejecuta [`mint format`](/es/cli/commands#mint-format).
+
+
+ ## Solución de problemas
+
+
+
## Iniciar sesión para búsqueda y asistente
diff --git a/es/deploy/authentication-setup.mdx b/es/deploy/authentication-setup.mdx
index b88460193..146c884bb 100644
--- a/es/deploy/authentication-setup.mdx
+++ b/es/deploy/authentication-setup.mdx
@@ -581,4 +581,4 @@ Algunas funciones se comportan de manera diferente o no están disponibles cuand
| [skill.md](/es/ai/skillmd) | Compatibilidad completa | No compatible | No compatible |
| [Mapa del sitio](/es/optimize/seo#sitemaps-and-robotstxt-files) | Compatibilidad completa | Disponible tras autenticación, pero excluye las páginas en groups | Disponible tras autenticación, pero excluye las páginas en groups |
| [robots.txt](/es/optimize/seo#sitemaps-and-robotstxt-files) | Compatibilidad completa | Disponible tras autenticación | Disponible tras autenticación |
-| [Vista previa en vivo](/es/editor/live-preview) | Compatibilidad completa | Compatible con autenticación automática del editor | Compatible con autenticación automática del editor |
+| [Vista previa en vivo](/es/editor/review#live-preview) | Compatibilidad completa | Compatible con autenticación automática del editor | Compatible con autenticación automática del editor |
diff --git a/es/editor/agent.mdx b/es/editor/agent.mdx
index 055114df8..499a55ee1 100644
--- a/es/editor/agent.mdx
+++ b/es/editor/agent.mdx
@@ -1,12 +1,12 @@
---
title: "Preguntar al agente"
-description: "Usa el agente de IA integrado del editor para escribir y editar páginas, dejar comentarios y sugerencias, buscar en el sitio y ajustar la configuración."
+description: "Use el agente de IA integrado del editor para escribir contenido, editar páginas, dejar comentarios y sugerencias, buscar en su sitio, subir archivos y ajustar la configuración."
keywords: ["editor", "AI", "assistant", "agent", "chat", "comments", "suggestions", "code mode", "file upload"]
---
-El editor incluye un agente integrado que puede editar páginas, reorganizar la navegación, actualizar `docs.json`, buscar en todo su repositorio y gestionar la configuración del panel.
+El editor incluye un agente integrado que puede editar páginas, reorganizar la navegación, actualizar `docs.json`, buscar en todo su repositorio y gestionar la configuración del dashboard.
-El agente del editor realiza los cambios directamente en la branch actual.
+El agente del editor realiza los cambios directamente en su branch actual.
@@ -14,21 +14,11 @@ El agente del editor realiza los cambios directamente en la branch actual.
-Haga clic en **Ask agent** en la barra de herramientas del editor, o presione Cmd + I (macOS) o Ctrl + I (Windows).
+Haga clic en **Ask agent** en la barra de herramientas del editor o presione Cmd + I (macOS) o Ctrl + I (Windows).
-Para cerrar el panel, haga clic en el botón **X** del encabezado del panel o vuelva a presionar Cmd + I.
+Escriba @ para mencionar una página concreta y el agente se centrará en ella. Sin una mención, usa la página que tiene abierta.
-
-
-## Enviar un mensaje
-
-
-
-Escriba su solicitud en el cuadro de chat en la parte inferior del panel y presione Enter o haga clic en el botón de envío
-## Solicitar comentarios y sugerencias
+## Pedir comentarios y sugerencias
-De forma predeterminada, el agente edita el contenido directamente. Para obtener feedback sin cambiar la página de inmediato, pídale explícitamente al agente que revise la página, deje comentarios o haga sugerencias.
+De forma predeterminada, el agente edita el contenido directamente. Para obtener opiniones sin cambiar la página de inmediato, pídale explícitamente que revise la página, deje comentarios o haga sugerencias.
-- Las [sugerencias](/es/editor/suggestions) proponen un reemplazo específico que puede aceptar o rechazar. El texto original permanece visible tachado hasta que decida, y el agente puede incluir una explicación en el hilo de la sugerencia.
-- Los [comentarios](/es/editor/comments) dejan feedback o una pregunta anclada a un texto específico sin cambiar la página.
+- Las [sugerencias](/es/editor/collaborate#suggestions) proponen un reemplazo concreto que puede aceptar o rechazar. El texto original permanece visible tachado hasta que decida, y el agente puede incluir una explicación en el hilo de la sugerencia.
+- Los [comentarios](/es/editor/collaborate#comments) dejan una opinión o una pregunta anclada a un texto concreto sin cambiar la página.
-Ejemplos de prompts:
+Prompts de ejemplo:
- `review this page and leave suggestions`
- `comment on anything that needs more context`
- `suggest ways to make the introduction more concise`
-El agente utiliza la página que tiene abierta en ese momento a menos que indique otra. Puede anotar el texto renderizado de la página, incluida la prosa dentro de los componentes, pero no el frontmatter, los metadatos de la página, la configuración ni las etiquetas y atributos crudos de los componentes MDX.
+El agente usa la página que tiene abierta salvo que indique otra. Puede anotar el texto representado de la página, incluida la prosa dentro de los componentes. No puede anotar el frontmatter, los metadatos de la página, la configuración ni las etiquetas y atributos MDX en bruto.
@@ -86,11 +76,11 @@ El agente utiliza la página que tiene abierta en ese momento a menos que indiqu
-A medida que el agente edita sus páginas, aparece un panel **Changed files** en el chat. Expándalo para ver una lista de cada archivo modificado en la sesión. Haga clic en cualquier archivo para abrirlo en la vista de diff y comparar los cambios del agente con el original.
+Aparece un panel **Changed files** en el chat mientras el agente trabaja. Despliéguelo para ver todos los archivos modificados en la sesión y haga clic en cualquiera para comparar los cambios con el original en la vista de diff.
-## Lo que el agente puede hacer
+## Qué puede hacer el agente
@@ -100,7 +90,7 @@ A medida que el agente edita sus páginas, aparece un panel **Changed files** en
@@ -172,4 +162,4 @@ Haga clic en el icono del reloj en el encabezado del panel para ver sus sesiones
-Para dar al agente pautas persistentes como reglas de voz, terminología o convenciones de formato, configure las instrucciones de IA en la [configuración del editor](/es/editor/settings#ai-instructions). El agente sigue estas instrucciones en cada solicitud sin que tenga que repetirlas.
+Para dar al agente directrices persistentes, como reglas de voz, terminología o convenciones de formato, configure las instrucciones de IA en la [configuración del editor](/es/editor/settings#ai-instructions). El agente sigue estas instrucciones en cada solicitud sin que tenga que repetirlas.
diff --git a/es/editor/branching-and-publishing.mdx b/es/editor/branching-and-publishing.mdx
deleted file mode 100644
index e1d097d1f..000000000
--- a/es/editor/branching-and-publishing.mdx
+++ /dev/null
@@ -1,264 +0,0 @@
----
-title: "Branches y publicación"
-description: "Comprenda cómo las branches y las reglas de protección determinan lo que sucede al publicar, y cómo gestionar el flujo completo de revisión y despliegue."
-keywords: ["editor", "branch", "publish", "pull request", "preview", "git", "merge", "deploy"]
----
-
-El editor web guarda todo automáticamente mientras escribe, pero sus cambios solo están en producción cuando decide publicarlos.
-
-Lo que sucede al publicar depende de dos cosas: **en qué branch se encuentre** y **si esa branch requiere pull requests**.
-
-
-
-## Guardar frente a publicar
-
-
-
-**Guardar** ocurre automáticamente. Mintlify almacena sus ediciones en sus servidores y las conserva entre pestañas del navegador, dispositivos e interrupciones de red.
-
-**Publicar** confirma sus cambios en su repositorio de Git. Haga clic en **Publish** en la barra de herramientas para abrir el menú de publicación, guardar sus cambios como un commit de Git y crear una pull request.
-
-El editor registra lo siguiente como cambios pendientes:
-
-- Ediciones de contenido en páginas
-- Páginas nuevas o eliminadas
-- Cambios en la estructura de navegación
-- Cargas de medios
-- Actualizaciones de configuración
-
-
-
-## Lo que sucede al publicar
-
-
-
-Las acciones disponibles al hacer clic en el botón de publicar dependen de la branch actual y de si tiene reglas de protección de branch que exigen pull requests.
-
-| Tipo de branch | Protección de branch | Acciones disponibles |
-|-------------|-------------------|-------------------|
-|
-
-## Cuándo usar una branch
-
-
-
-**Edite directamente en su deployment branch** si no utiliza un flujo de trabajo basado en Git.
-
-**Cree una branch** cuando utilice un flujo de trabajo basado en branches en el que realiza cada cambio en su contenido en una branch separada.
-
-
-
-## Crear y cambiar de branch
-
-
-
-
-
-### Crear una branch
-
-
-
-1. Haga clic en el nombre de la branch en la barra de herramientas del editor.
-1. Haga clic en **Create new branch**.
-1. Si tiene cambios pendientes, elija si llevarlos a la nueva branch o dejarlos en la branch actual.
-1. Introduzca un nombre y haga clic en **Create branch**.
-
-
-
-### Cambiar de branch
-
-
-
-1. Haga clic en el nombre de la branch en la barra de herramientas.
-1. Busque o desplácese hasta la branch que desee.
-1. Haga clic en la branch para cambiar a ella.
-
-
-
-## Previsualizar sus cambios
-
-
-
-Cada vez que guarda cambios en una feature branch, Mintlify compila un despliegue de vista previa, una URL temporal donde sus cambios se renderizan exactamente como cuando se publican.
-
-
-
-1. Haga clic en **Publish** en la barra de herramientas del editor.
-1. En el menú de publicación, haga clic en la URL de vista previa. El formato de la URL es `organization-branch-name.mintlify.site`.
-
-
-
-
-
-Copie la URL y envíela a los revisores. La vista previa se actualiza automáticamente cada vez que guarda en la branch.
-
-
-
-### Restringir el acceso a las vistas previas
-
-
-
-Las URLs de vista previa son públicamente accesibles por defecto. Para restringir el acceso a los miembros de su organización en Mintlify, habilite la autenticación de vista previa en la página [Add-ons](https://app.mintlify.com/products/addons) de su panel.
-
-
-
-Para invitar a un compañero de equipo a una página específica en una branch, copie la URL de la barra de direcciones de su navegador y compártala. Cualquier persona con acceso a su organización de Mintlify puede abrir el enlace directamente en su sesión del editor.
-
-El formato de la URL es:
-
-```text
-https://app.mintlify.com/{org}/{project}/editor/{branch}/~/{filepath}
-```
-
-Por ejemplo: `https://app.mintlify.com/acme/docs/editor/main/~/guides/quickstart.mdx`
-
-
-
-## Revisar y fusionar pull requests
-
-
-
-Cuando hay una pull request abierta para la branch actual, el menú de publicación muestra un panel de revisión con:
-
-- El título y la descripción de la pull request, y si es un borrador.
-- Las branches de origen y de destino.
-- El número de archivos modificados.
-- El requisito de aprobación en la deployment branch: **Approval required**, **Code owner required** o sin requisito.
-- El estado actual de la revisión: **Approved**, **Changes requested** o **Awaiting review**.
-
-Haga clic en el enlace de la pull request para abrirla en GitHub, GitLab o Bitbucket.
-
-Después de que un revisor apruebe una pull request, haga clic en **Merge and publish** para fusionar y desplegar directamente desde el editor. El editor cambia a su deployment branch después de fusionar.
-
-
-
-### Aprobar pull requests desde el editor
-
-
-
-Para los repositorios de GitHub, los revisores pueden aprobar pull requests abiertas en el editor. Cuando hay una pull request abierta, aparece el botón **Approve pull request** en el panel de revisión si su cuenta tiene permiso para revisarla. Haga clic en **Approve pull request** cuando los cambios estén listos para fusionarse. El estado de la revisión cambia a **Approved** y la acción **Merge and publish** queda disponible.
-
-Si usa GitLab o Bitbucket, abra la pull request en su proveedor de Git para aprobarla.
-
-
-
-### Revisar los cambios antes de fusionar
-
-
-
-Haga clic en cualquier archivo modificado en el menú de publicación para abrirlo en la vista de diff y comparar su branch con la versión publicada. En modo visual verá un diff visual. En modo source verá un diff de texto. Los archivos que no pueden mostrar un diff, como imágenes o archivos eliminados, aparecen en la lista pero no se pueden abrir.
-
-El árbol de archivos resalta las páginas modificadas para que pueda ver de un vistazo qué archivos ha tocado una [automatización](/es/automations) o un compañero de equipo. Las páginas no listadas que aparecen en el diff de la branch también se pueden abrir desde el menú de publicación, aunque no aparezcan en la navegación de su sitio.
-
-
-
-### Abrir una ejecución de automatización en el editor
-
-
-
-Cuando una [automatización](/es/automations) abre una pull request, puede saltar directamente desde la interfaz de revisión de la ejecución o desde su notificación de Slack al editor en la branch de la automatización:
-
-- Desde la página **Automation Runs** en su panel, haga clic en **Open in editor** en una ejecución completada.
-- Desde una notificación de Slack, haga clic en el enlace **View changes**.
-
-Cualquiera de los dos accesos abre el editor en la branch de la automatización con las páginas modificadas preseleccionadas en el menú de publicación. Puede revisar el diff y fusionar o solicitar cambios sin salir del editor.
-
-
-
-### Publicaciones simultáneas
-
-
-
-Solo puede haber una publicación a la vez por branch. Si otro miembro del equipo publica en la misma branch, espere a que termine la publicación actual antes de volver a intentarlo.
-
-
-
-### Títulos y descripciones de pull requests
-
-
-
-Si su organización requiere pull requests, puede introducir un título y una descripción al publicar. Si deja cualquiera de los dos en blanco, el editor usa un mensaje predeterminado que enumera los archivos que ha creado, actualizado, movido o eliminado.
-
-
-
-## Resolver conflictos
-
-
-
-Los conflictos ocurren cuando su branch y la deployment branch tienen cambios incompatibles en los mismos archivos. Por ejemplo, cuando usted y un compañero de equipo han editado las mismas líneas en un archivo o han movido un archivo a ubicaciones diferentes.
-
-El editor muestra una advertencia cuando los conflictos bloquean la publicación. Siga las indicaciones para elegir qué versión de cada sección en conflicto conservar.
-
-
-
-## Colaborar en tiempo real
-
-
-
-Cuando varias personas abren la misma página en la misma branch, editan juntas en tiempo real. El cursor y las ediciones de cada persona son visibles para todos, con avatares mostrados en la barra de herramientas.
-
-- Los cambios de todos los colaboradores se fusionan automáticamente. Dos personas editando la misma sección no generarán conflictos.
-- Deshacer solo afecta a sus propias ediciones.
-- Si pierde la conexión, las ediciones se guardan localmente y se sincronizan cuando se vuelve a conectar.
-
-Cuando el [agente de Mintlify](/es/agent) edita una página a través de la API o MCP, aparece en el editor como cualquier otro colaborador. Verá el avatar del agente en la barra de herramientas y un cursor en vivo en su edición más reciente. El cursor desaparece automáticamente después de que el agente termina.
-
-
-
-## Sincronización con Git
-
-
-
-Cuando alguien envía cambios a su repositorio desde fuera del editor, el editor incorpora esos cambios automáticamente.
-
-Los cambios que no se solapan se aplican automáticamente. Si un cambio remoto y su edición local afectan a la misma parte de una página, el editor resalta el conflicto para que pueda resolverlo.
-
-
-
-## Firma de commits
-
-
-
-Firme commits con su cuenta de GitHub autorizándola en la [configuración de su cuenta](https://app.mintlify.com/settings/account). Sin autorización, la app de GitHub de Mintlify firma los commits realizados en el editor web.
-
-Para una referencia de cómo las acciones del editor se corresponden con las operaciones de Git, consulte [Conceptos básicos de Git](/es/editor/git-essentials#how-the-editor-maps-to-git).
diff --git a/es/editor/collaborate.mdx b/es/editor/collaborate.mdx
new file mode 100644
index 000000000..d2bea2e0b
--- /dev/null
+++ b/es/editor/collaborate.mdx
@@ -0,0 +1,82 @@
+---
+title: "Colaborar en el editor"
+sidebarTitle: "Colaborar"
+description: "Deje comentarios, proponga cambios como sugerencias y edite junto a sus compañeros en tiempo real en el editor."
+keywords: ["comments", "suggestions", "collaboration", "review", "mentions", "real time"]
+---
+
+Trabaje con su equipo en una página comentándola, sugiriendo cambios o editándola conjuntamente al mismo tiempo.
+
+
+
+## Comentarios
+
+
+
+Los comentarios le permiten dejar opiniones sobre un texto concreto sin editar el contenido.
+
+**Los comentarios nunca llegan a su repositorio.** Existen solo dentro del editor y nunca se incluyen en el sitio publicado ni se confirman en Git.
+
+Para añadir un comentario, resalte un texto y haga clic en el icono
+
+
+
+Todos los [roles](/es/dashboard/roles) pueden comentar y responder, incluidos los viewers. Solo los editors y admins pueden resolver hilos. Resolver un hilo lo quita de la barra lateral y elimina el resaltado de la página.
+
+Puede eliminar sus propios comentarios y los admins pueden eliminar cualquier comentario. Eliminar el primer comentario de un hilo elimina el hilo completo.
+
+Escriba `@` para mencionar a un compañero. Debe ser miembro de su organización y recibirá una notificación por correo electrónico.
+
+Si su branch tiene una pull request abierta, Mintlify añade a su descripción un resumen de los hilos sin resolver, con un enlace a cada comentario. El resumen se actualiza a medida que cambian los hilos.
+
+
+
+## Sugerencias
+
+
+
+Las sugerencias proponen un cambio manteniendo el contenido actual, de modo que un compañero pueda aceptarlas o rechazarlas.
+
+Los editors y admins pueden aceptar o rechazar cualquier sugerencia. Los viewers no.
+
+Para hacer una sugerencia, resalte un texto y haga clic en el botón
+
+## Preguntar al agente de Mintlify
+
+
+
+Mencione `@mintlify` en un comentario, una sugerencia o una respuesta para preguntar al [agente del editor](/es/editor/agent) sobre la página actual. El agente se ejecuta en segundo plano con la página, el hilo y la branch como contexto, y luego publica su respuesta en el mismo hilo.
+
+```text
+@mintlify does this endpoint support pagination?
+@mintlify are there any pages that contradict this?
+```
+
+El agente funciona en modo de solo lectura cuando responde a comentarios. Puede buscar en su documentación, leer páginas, consultar contenido web y cargar skills, pero no puede editar contenido, crear sugerencias ni publicar. Para hacer cambios, abra directamente el [agente del editor](/es/editor/agent).
+
+Las menciones funcionan en páginas privadas para los miembros que ya tienen acceso. Cada respuesta cuenta para su uso del agente del editor.
+
+
+
+## Edición en tiempo real
+
+
+
+Cuando varias personas abren la misma página en la misma branch, editan conjuntamente. El cursor y las ediciones de cada persona son visibles para todos, con avatares en la barra de herramientas.
+
+- Los cambios de todos los colaboradores se combinan automáticamente. Que dos personas editen la misma sección no genera conflictos.
+- Deshacer solo afecta a sus propias ediciones.
+- Si pierde la conexión, sus ediciones se guardan localmente y se sincronizan cuando vuelve a conectarse.
+
+Cuando el [agente de Mintlify](/es/agent) edita una página a través de la API o de MCP, aparece como cualquier otro colaborador, con un avatar y un cursor en vivo en su edición más reciente. El cursor desaparece cuando el agente termina.
diff --git a/es/editor/comments.mdx b/es/editor/comments.mdx
deleted file mode 100644
index 6227c572b..000000000
--- a/es/editor/comments.mdx
+++ /dev/null
@@ -1,108 +0,0 @@
----
-title: "Comentarios"
-description: "Deja comentarios en línea en las páginas del editor para dar retroalimentación, mencionar compañeros, hacer preguntas y discutir cambios con tu equipo."
-keywords: ["editor", "comentarios", "colaboración", "retroalimentación", "menciones", "hilos"]
----
-
-Los comentarios te permiten a ti y a tu equipo dejar retroalimentación sobre texto específico de una página sin editar el contenido. Usa los comentarios para hacer preguntas, señalar problemas o discutir cambios antes de publicarlos.
-
-Los comentarios solo existen dentro del editor. Nunca se incluyen en el sitio publicado ni se envían a tu repositorio.
-
-Todos los [roles](/es/dashboard/roles)—viewers, editors y admins—pueden dejar comentarios y responder a ellos. Solo los editors y admins pueden resolver hilos de comentarios.
-
-Si tu branch tiene una pull request abierta, Mintlify agrega un resumen de los hilos de comentarios sin resolver a la descripción de la pull request. El resumen enumera los archivos con comentarios abiertos, el primer comentario de cada hilo y un enlace para navegar hasta el comentario en el editor.
-
-El resumen se actualiza cuando agregas, resuelves o eliminas un comentario.
-
-
- ## Agregar un comentario
-
-
-1. Resalta el texto sobre el que quieres comentar.
-2. Haz clic en el icono
-
-
-
-
-
-Para abrir un hilo de comentarios, haz clic en el texto resaltado o en el hilo en la barra lateral de comentarios. Escribe tu respuesta y presiona Enter para enviarla.
-
-
-
-
-
-
-
- ## Mencionar a un compañero
-
-
-Escribe `@` en un comentario o respuesta para mencionar a un compañero. Las personas deben ser miembros de tu organización para que puedas mencionarlas.
-
-Los compañeros mencionados reciben una notificación por correo electrónico.
-
-
- ## Preguntar al agente de Mintlify
-
-
-Menciona `@mintlify` en un comentario, [sugerencia](/es/editor/suggestions) o respuesta para hacerle una pregunta al [agente del editor](/es/editor/agent) sobre la página actual. El agente se ejecuta de forma asíncrona con la página, el hilo y la branch como contexto, y luego publica su respuesta como una nueva respuesta en el mismo hilo.
-
-Usa las menciones `@mintlify` para hacer preguntas como:
-
-- `@mintlify does this endpoint support pagination?`
-- `@mintlify is this the recommended way to configure webhooks?`
-- `@mintlify are there any pages that contradict this?`
-
-El agente se ejecuta en modo de solo lectura cuando responde a comentarios. Puede buscar en tu documentación, leer páginas, obtener contenido web y cargar skills, pero no puede editar contenido, crear sugerencias ni publicar cambios. Para hacer cambios, abre el [agente del editor](/es/editor/agent) directamente.
-
-Las menciones `@mintlify` funcionan en páginas privadas para los miembros que ya tienen acceso. Cada respuesta del agente cuenta para tu uso del agente del editor.
-
-
- ## Resolver un comentario
-
-
-Los editors y admins pueden resolver los hilos cuando la discusión finaliza.
-
-Haz clic en el icono de marca de verificación para resolver un hilo. Los hilos resueltos se eliminan de la barra lateral de comentarios y se elimina el resaltado de la página.
-
-
-
-
-
-
-
- ## Eliminar un comentario
-
-
-Haz clic en el icono de papelera junto a un comentario para eliminarlo. Eliminar el primer comentario de un hilo elimina todo el hilo.
-
-Puedes eliminar tus propios comentarios. Los admins pueden eliminar cualquier comentario.
diff --git a/es/editor/configurations.mdx b/es/editor/configurations.mdx
deleted file mode 100644
index 3d302ee13..000000000
--- a/es/editor/configurations.mdx
+++ /dev/null
@@ -1,274 +0,0 @@
----
-title: "Configuraciones"
-description: "Edite la marca, apariencia, navegación y funciones desde el panel Configurations en el editor web de Mintlify, con sincronización en tiempo real."
-keywords: ["editor", "configurations", "settings", "branding", "theme"]
-boost: 3
----
-
-Configure la marca, la apariencia y las funciones de su sitio desde el panel **Site configurations** en el editor web. Los cambios de configuración se sincronizan en tiempo real con otros editores en la misma branch, de modo que su equipo siempre ve los ajustes más recientes.
-
-Para abrir el panel, haga clic en el icono de configuraciones
-
-
-
-El panel agrupa los ajustes en secciones que se corresponden con las propiedades de nivel superior de su [`docs.json`](/es/organize/settings).
-
-
-
-## General
-
-
-
-Establezca la identidad de su sitio y cómo aparece para los visitantes.
-
-- **Name**: El nombre de su proyecto. Aparece en las pestañas del navegador y en los resultados de búsqueda.
-- **Description**: Breve descripción de su proyecto. Se utiliza para SEO y AEO.
-
-
-
-## Marca
-
-
-
-Suba las marcas que identifican su sitio.
-
-- **Logo**: El logo de su marca. Suba archivos PNG o JPG. Establezca versiones separadas para modo claro y oscuro y una URL opcional al hacer clic. Para usar un logo SVG, añada el archivo a su repositorio y referencie su ruta en su [`docs.json`](/es/organize/settings-appearance#logos).
-- **Favicon**: Pequeño icono que aparece en las pestañas del navegador. Suba archivos ICO, PNG, GIF o JPG. Establezca versiones separadas para modo claro y oscuro si es necesario.
-
-
-
-## Estilo
-
-
-
-Controle la identidad visual y la paleta de colores de su sitio.
-
-- **Theme**: Elija un [tema](/es/customize/themes) para la apariencia general de su sitio.
-- **Primary color**: El color de acento principal usado en todo su sitio para enlaces, botones y elementos destacados.
-- **Light color**: Color de acento usado en modo oscuro. La forma en que los temas lo aplican varía según el tema.
-- **Dark color**: Color de acento usado en modo claro. La forma en que los temas lo aplican varía según el tema.
-- **Background color**: Colores de fondo personalizados para modo claro y oscuro.
-- **Icon library**: Biblioteca de iconos usada para todas las propiedades de iconos. El valor predeterminado es `fontawesome`.
-- **Strict appearance**: Bloquea el sitio en un único modo de apariencia y oculta el conmutador de tema.
-- **Default appearance**: Indica si su sitio se carga en modo `system`, `light` o `dark` por defecto.
-- **Background decoration**: Aplica un estilo visual (`gradient`, `grid` o `windows`) al fondo.
-- **Background image**: Imagen de fondo opcional. Establezca una sola imagen o versiones separadas para modo claro y oscuro.
-
-
-
-## Tipografía
-
-
-
-Reemplace las fuentes predeterminadas con la tipografía de su marca.
-
-- **Font family**: Cualquier familia de [Google Fonts](https://fonts.google.com/) funciona sin configuración adicional. Para una fuente alojada por usted mismo, proporcione una URL de origen y un formato (`woff` o `woff2`).
-- **Weight**: Normalmente `400` para regular y `700` para negrita. Las fuentes variables admiten pesos precisos como `550`.
-- **Heading font**: Anulación opcional aplicada a todos los encabezados (`h1` a `h6`).
-- **Body font**: Anulación opcional aplicada al cuerpo de texto y al resto de la página.
-
-
-
-Añada elementos de navegación a la parte superior de su sitio.
-
-- **Primary button**: La llamada a la acción principal en su cabecera. Establezca el tipo, la etiqueta y la URL de destino.
-- **Navbar links**: Enlaces de navegación adicionales en su cabecera. Cada enlace incluye un texto y una URL.
-
-
-
-Añada enlaces y perfiles de redes sociales al pie de página de su sitio.
-
-- **Social links**: Perfiles en plataformas como GitHub, X, LinkedIn, Discord, YouTube y Slack.
-- **Footer columns**: Habilítelo para organizar los enlaces del pie de página en hasta cuatro columnas con encabezados personalizados.
-
-
-
-Muestre una barra de anuncios en la parte superior de cada página.
-
-- **Content**: El texto del banner. Admite formato MDX básico como enlaces, negrita y cursiva. Los componentes personalizados no son compatibles.
-- **dismissible**: Muestra un botón para descartar en el lado derecho del banner.
-- **Type**: Estilo visual. `info` usa el color primario de la marca, `warning` usa un fondo ámbar y `critical` usa un fondo rojo. El valor predeterminado es `info`.
-- **Color**: Anula el color de fondo del banner con un color hexadecimal personalizado. Establezca valores separados para modo claro y oscuro para colores adaptables al tema.
-
-
-
-## Miniatura
-
-
-
-Personalice las miniaturas de las páginas y las vistas previas para redes sociales.
-
-- **Background**: Imagen de fondo personalizada para las miniaturas.
-- **Appearance**: Renderiza las miniaturas en modo `light` o `dark`. Cuando no se define, las miniaturas se generan automáticamente a partir de los colores de su tema.
-- **Font**: Fuente personalizada para el texto en las miniaturas.
-
-
-
-## Contenido
-
-
-
-Personalice cómo aparece el contenido en su sitio.
-
-- **Page eyebrow**: Muestra etiquetas pequeñas que preceden a los títulos de las páginas. Elija `section` o `breadcrumbs`.
-- **Timestamps**: Muestra la fecha de la última modificación del contenido en todas las páginas.
-- **LaTeX**: Carga las hojas de estilo de LaTeX (KaTeX) para renderizar notación matemática.
-
-
-
-## Bloques de código
-
-
-
-Configure el resaltado de sintaxis y el comportamiento de los bloques de código.
-
-- **Code block theme**: Iguala el modo claro/oscuro del sitio con `system`, usa siempre un tema oscuro con `dark` o elija un tema personalizado de [Shiki](https://shiki.style/).
-- **Custom code languages**: Registre lenguajes adicionales para el resaltado de sintaxis.
-
-
-
-Configure las acciones rápidas que aparecen en el menú contextual de la página.
-
-- **Options**: Menú desplegable de selección múltiple con acciones como `copy`, `view` y abrir la página en `chatgpt`, `claude`, `cursor` y otros asistentes de IA.
-- **Display**: Dónde mostrar las opciones. `header` (predeterminado) las muestra en el menú contextual en la parte superior de la página; `toc` las muestra en la barra lateral del índice de contenido.
-
-
-
-Ajuste el comportamiento de la navegación en todo su sitio.
-
-- **drilldown**: Navega automáticamente a la primera página cuando un usuario hace clic en un grupo de navegación.
-
-
-
-## Búsqueda
-
-
-
-Personalice la experiencia de búsqueda y los comentarios.
-
-- **Search placeholder**: El texto que aparece en el cuadro de búsqueda antes de que los usuarios escriban. El valor predeterminado es `Search or ask`.
-- **Feedback**: Muestra botones de pulgar arriba y pulgar abajo o un enlace "Suggest edits" en cada página.
-
-
-
-## Referencia de API
-
-
-
-Documente los endpoints de su API.
-
-- **OpenAPI specs**: Añada archivos de especificación OpenAPI para generar páginas de referencia de API.
-- **AsyncAPI specs**: Añada archivos de especificación AsyncAPI para generar páginas de referencia de API.
-- **MDX server**: Endpoints personalizados del servidor MDX para el playground de API.
-- **Playground display**: Muestra el playground interactivo de la API, el playground simple de la API o ningún playground de API.
-- **Proxy server**: Habilita o deshabilita el servidor proxy para las solicitudes de API.
-- **`mdx.schema`**: Indica si se renderiza la sección de esquema en las páginas de referencia de API.
-
-
-
-## Redirecciones
-
-
-
-Use la sección **Redirects** para añadir, editar, buscar y eliminar redirecciones sin editar manualmente su archivo `docs.json`. Las redirecciones envían a los usuarios desde URLs antiguas a otras nuevas, lo cual es útil cuando renombra páginas o reestructura su sitio. Para más información, consulte [Redirecciones](/es/create/redirects).
-
-Cada redirección tiene los siguientes campos:
-
-- **Source**: La ruta desde la que redirigir, como `/old-path`. Admite comodines.
-- **Destination**: La ruta a la que redirigir, como `/new-path`. Admite comodines.
-- **Status**: El código de estado HTTP para la redirección.
- - `308`: Redirección permanente. Úselo para contenido que se ha movido de forma permanente. Este es el estado predeterminado.
- - `307`: Redirección temporal. Úselo cuando el movimiento es temporal.
-
-
-
-
-
-
-Para añadir una redirección:
-
-1. Haga clic en **Add redirect**.
-2. Introduzca el origen y el destino.
-3. Haga clic en **Save**.
-
-Para editar o eliminar una redirección existente, pase el cursor sobre la fila y use el icono de edición en línea o la **X** para eliminarla.
-
-
-
-## SEO
-
-
-
-Configure las metaetiquetas y la indexación para los motores de búsqueda.
-
-- **metatags**: Etiquetas `` personalizadas aplicadas en todo su sitio. Añada pares clave-valor para etiquetas como `og:image` o `twitter:card`.
-- **Indexing**: Elija si se deben indexar las páginas ocultas.
-
-
-
-## Analítica
-
-
-
-Conecte plataformas de analítica para rastrear el comportamiento de los visitantes. Los proveedores admitidos incluyen Amplitude, Mixpanel, Heap, Google Analytics, Google Tag Manager, PostHog, Plausible, Fathom, Segment, Hightouch, Hotjar, LogRocket, Microsoft Clarity, Intercom, Clearbit y más.
-
-Cada entrada se muestra como una fila en línea. Use el icono **X** para eliminar una integración.
-
-
-
-## Página 404
-
-
-
-Personalice la experiencia cuando un usuario llega a una página inexistente.
-
-- **Redirect to home**: Cuando está activado, las páginas inexistentes redirigen a su página de inicio. Cuando está desactivado, el sitio muestra una página 404 y puede personalizar el título y la descripción a continuación.
-- **Title**: Encabezado que se muestra en la página 404.
-- **Description**: Subtítulo que se muestra en la página 404.
-
-
-
-## Variables
-
-
-
-Defina variables personalizadas que se pueden reutilizar en todo su contenido. Cada variable es un par clave-valor. Use el icono **X** para eliminar una variable.
diff --git a/es/editor/git-essentials.mdx b/es/editor/git-essentials.mdx
deleted file mode 100644
index 4f168d6e2..000000000
--- a/es/editor/git-essentials.mdx
+++ /dev/null
@@ -1,84 +0,0 @@
----
-title: "Conceptos básicos de Git para el editor"
-sidebarTitle: "Conceptos básicos de Git"
-description: "Comprenda los conceptos de control de versiones de Git detrás del editor de Mintlify: branches, commits, pull requests y flujos de fusión."
-keywords: ["git", "version control", "web editor", "branches", "commits", "pull requests", "PRs"]
----
-
-Git le permite controlar y hacer seguimiento de los cambios en los archivos. Es el sistema de control de versiones detrás de los flujos de trabajo basados en branches, donde gestiona el contenido del mismo modo que cualquier otra base de código.
-
-El editor web se encarga de las operaciones de Git por usted. Comprender algunos conceptos clave le ayuda a aprovechar al máximo el editor y a colaborar eficazmente con su equipo.
-
-
-
-## Lo que Git hace por su contenido
-
-
-
-Git registra cada cambio realizado en su contenido. Anota qué cambió, quién lo cambió, cuándo lo cambió y por qué. Esto significa que puede:
-
-- Ver el historial completo de cualquier página.
-- Deshacer cambios revirtiendo a una versión anterior.
-- Trabajar en actualizaciones sin afectar a su sitio en producción.
-- Revisar los cambios antes de que se publiquen.
-
-Su repositorio es la colección de archivos y su historial que conforman su sitio. El editor se conecta a este repositorio para sincronizar y publicar su contenido.
-
-
-
-## Conceptos clave
-
-
-
-Estos son los conceptos de Git con los que se encontrará con más frecuencia al usar el editor web.
-
-
-
-## Cómo se relaciona el editor con Git
-
-
-
-Cada acción en el editor web corresponde a una operación de Git. Aquí está la referencia completa:
-
-| Acción en el editor | Operación de Git |
-|---|---|
-| Editar una página | Los cambios se guardan automáticamente en los servidores de Mintlify. Aún no hay commit de Git. |
-| Publicar en su deployment branch | `git commit` y `git push`. Desencadena un despliegue. |
-| Save in branch | `git commit` en la feature branch actual. |
-| Create pull request | `git push` y abre una pull request contra su deployment branch. |
-| Merge and publish | Fusiona la pull request y desencadena un despliegue. |
-| Crear una branch | `git checkout -b
+Use el editor para escribir y publicar documentación en su navegador. El editor usa un flujo de trabajo docs-as-code en el que Git respalda todos sus cambios. Su trabajo se guarda como commits en su repositorio y el editor gestiona las operaciones de Git por usted.
-## Abrir el editor
-
-
-
-Abre el editor desde la pestaña [Editor](https://app.mintlify.com/editor) en tu dashboard de Mintlify. Cualquier miembro de tu organización puede abrir el editor; lo que puedes hacer dentro depende de tu [rol](/es/dashboard/roles). Los admins y editors pueden editar y publicar, y los viewers pueden explorar el contenido y dejar [comentarios](/es/editor/comments) o [sugerencias](/es/editor/suggestions).
+El editor se carga de forma predeterminada cuando abre su [dashboard](https://app.mintlify.com). Cualquier miembro de su organización puede abrirlo, pero ciertas acciones dependen de su [rol](/es/dashboard/roles). Los admins y editors pueden editar y publicar. Los viewers pueden explorar el contenido y dejar [comentarios y sugerencias](/es/editor/collaborate).
@@ -23,78 +19,84 @@ Abre el editor desde la pestaña [Editor](https://app.mintlify.com/editor) en tu
-**Los cambios se guardan automáticamente.** A medida que escribe, el editor guarda su trabajo. Sus cambios persisten entre pestañas, dispositivos e interrupciones de red. Los cambios solo se publican cuando usted los publica.
+**Los cambios se guardan automáticamente, pero guardar es distinto de publicar.** A medida que escribe, el editor almacena su trabajo. Sus cambios persisten entre pestañas, dispositivos e interrupciones de red. Para que un cambio llegue a su sitio publicado, debe [publicarlo](/es/editor/publish).
-**Git se mantiene sincronizado.** Cuando alguien envía cambios a su repositorio desde fuera del editor, esos cambios aparecen automáticamente en el editor. No necesita hacer pull ni actualizar. El editor fusiona los cambios que no entran en conflicto y resalta lo que requiere su atención.
+**Publicar escribe en Git.** Cuando publica, el editor hace commit de sus cambios en su repositorio. Si publica en su deployment branch, su sitio publicado se actualiza de inmediato. En una feature branch, puede elegir si al publicar se actualiza el sitio publicado de inmediato o se abre una pull request para revisión.
-
+
-
+
+
-- **Barra superior**: Use la barra superior para controlar en qué branch trabaja, acceder al agente, ver una vista previa y publicar los cambios.
-- **Barra lateral de navegación**: Seleccione una página para editar, cree nuevas páginas y administre la estructura del sitio.
+* **Barra superior**: Use la barra superior para controlar en qué branch trabaja, acceder al agente, previsualizar y publicar cambios.
+* **Barra lateral**: Use la barra lateral para seleccionar páginas que editar, crear páginas nuevas y gestionar la estructura de su sitio.
+ * **Home**: El árbol de archivos de su proyecto. Las páginas en **Personal** son privadas para usted. Las páginas en **Workspace** son públicas para su organización.
+ * **Publishing**: La estructura de navegación de su sitio. Organice las páginas como quiere que aparezcan en su sitio.
-
-## El diseño del editor
+## Diseño del editor
-
-
+
+
-- **Barra superior**: Use la barra superior para controlar en qué branch trabaja, acceder al agente, ver una vista previa y publicar los cambios.
-- **Barra lateral de navegación**: Seleccione una página para editar, cree nuevas páginas y administre la estructura del sitio.
+* **Barra superior**: Use la barra superior para controlar en qué branch trabaja, acceder al agente, previsualizar y publicar cambios.
+* **Barra lateral**: Use la barra lateral para seleccionar páginas que editar, crear páginas nuevas y gestionar la estructura de su sitio.
+ * **Home**: El árbol de archivos de su proyecto. Las páginas en **Personal** son privadas para usted. Las páginas en **Workspace** son públicas para su organización.
+ * **Publishing**: La estructura de navegación de su sitio. Organice las páginas como quiere que aparezcan en su sitio.
-
+
- Cómo las branches y las reglas de protección determinan lo que sucede al publicar, y cómo gestionar el proceso de revisión de pull requests.
-
-
-
- Deja retroalimentación, haz preguntas y discute los cambios con tu equipo.
-
-
-
- Propón cambios que tus compañeros pueden revisar, aceptar o rechazar.
-
+**El modo visual** representa su página a medida que escribe. Presione / para abrir el menú de componentes e insertar componentes.
-
- Edite páginas, busque su contenido, modifique ajustes y configure su sitio desde una interfaz de chat.
-
+**El modo source** le da acceso directo al MDX. Úselo para tener control preciso sobre las propiedades de los componentes y el frontmatter.
-
- Añada páginas nuevas y actualice las existentes.
-
+Ambos modos editan el mismo archivo. Cambie entre ellos con Cmd + Shift + S (macOS) o Ctrl + Shift + S (Windows).
-
- Reordene las páginas y administre la estructura del sitio.
-
+Para conocer los componentes que puede insertar, consulte [Componentes](/es/components). Para la sintaxis de MDX, consulte [Dar formato al texto](/es/create/text) y [Dar formato al código](/es/create/code).
-
- Previsualice su sitio en tiempo real mientras edita, sin esperar a una compilación.
-
+
- Ahorre tiempo con atajos de teclado.
-
+Entender algunos conceptos de Git le ayuda a aprovechar mejor el editor.
+
+
+
+ Una instantánea guardada de sus cambios en un momento concreto, con un mensaje que describe qué cambió. Publicar crea un commit.
+
+
+ Una línea de trabajo independiente. Su sitio publicado se compila desde una **deployment branch**, normalmente `main`. Otras branches, a veces llamadas **feature branches**, le permiten trabajar sin afectar su sitio publicado. Nada en una feature branch se publica hasta que hace merge.
+
+
+ Una propuesta para hacer merge de una branch en otra, de modo que su equipo pueda revisar los cambios antes de que se publiquen. Su equipo revisa y hace merge de las pull requests en GitHub, GitLab o Bitbucket, o [desde el editor](/es/editor/review).
+
+
+ Combinar los cambios de una branch en otra. Hacer merge en su deployment branch publica esos cambios.
+
+
+ Dos branches con cambios incompatibles en las mismas líneas. El editor le pide que elija qué versión conservar para resolver los conflictos antes de hacer merge.
+
+
+ Una comparación entre dos versiones de un archivo. El editor muestra un diff de sus cambios pendientes antes de que publique.
+
+
+
+| Acción en el editor | Operación de Git |
+|---|---|
+| Editar una página | Se guarda automáticamente. Todavía no hay commit. |
+| Publicar en su deployment branch | `git commit` y `git push`. Activa un despliegue. |
+| Save in branch | `git commit` en la feature branch actual. |
+| Create pull request | `git push` y abre una pull request contra su deployment branch. |
+| Merge and publish | Hace merge de la pull request y activa un despliegue. |
+| Crear una branch | `git checkout -b ` |
+| Cambiar de branch | `git checkout ` |
+| Push externo o actualización por CLI | Los cambios entrantes se sincronizan en el editor mediante un merge de tres vías. |
diff --git a/es/editor/keyboard-shortcuts.mdx b/es/editor/keyboard-shortcuts.mdx
index 398c0b728..21b1e6586 100644
--- a/es/editor/keyboard-shortcuts.mdx
+++ b/es/editor/keyboard-shortcuts.mdx
@@ -1,10 +1,10 @@
---
title: "Atajos de teclado"
-description: "Consulte la lista completa de atajos de teclado para el editor web de Mintlify, incluyendo comandos de formato de texto, navegación y edición."
+description: "Consulte la lista completa de atajos de teclado del editor web de Mintlify, incluidos los comandos de formato de texto, navegación y edición."
keywords: ["editor", "keys", "keyboard", "shortcuts"]
---
-Use atajos de teclado para navegar y editar más rápido en el editor web. El editor admite atajos comunes como copiar, pegar, deshacer y seleccionar todo, junto con los atajos que se enumeran a continuación.
+Use los atajos de teclado para navegar y editar más rápido en el editor web. El editor admite atajos habituales como copiar, pegar, deshacer y seleccionar todo, además de los atajos que se enumeran a continuación.
-## Explorar el editor
+## Modo visual y modo source
-
-
- Configure la marca, los colores y las funciones de su sitio.
-
+## Conceptos de Git
-
- Configure las instrucciones de IA y los ajustes predeterminados de publicación para su deployment.
-
-
-
- Comprenda los conceptos de Git en los que se basa el editor: branches, commits, pull requests y merges.
-
+
-
@@ -12,16 +12,14 @@ Use atajos de teclado para navegar y editar más rápido en el editor web. El ed
-Estos atajos funcionan independientemente del modo en el que se encuentre.
+Estos atajos funcionan sea cual sea el modo en el que esté.
| Comando | macOS | Windows |
| :--- | :--- | :--- |
| **Buscar archivos y contenido** | Cmd + K | Ctrl + K |
-| **Alternar el asistente de IA** (cuando no se edita texto) | Cmd + I | Ctrl + I |
-| **Alternar entre modo visual y source** | Cmd + Shift + S | Ctrl + Shift + S |
-| **Alternar la vista de diff** | Cmd + Shift + D | Ctrl + Shift + D |
-| **Alternar entre Navigation y árbol de Files** | Cmd + Shift + F | Ctrl + Shift + F |
-| **Ocultar/mostrar la barra lateral** | Cmd + \\ | Ctrl + \\ |
+| **Mostrar u ocultar el asistente de IA** (cuando no está editando texto) | Cmd + I | Ctrl + I |
+| **Cambiar entre el modo visual y el modo source** | Cmd + Shift + S | Ctrl + Shift + S |
+| **Mostrar todos los archivos** (incluidos los dotfiles y los archivos que no son de contenido) | Cmd + Shift + . | Ctrl + Shift + . |
@@ -29,7 +27,7 @@ Estos atajos funcionan independientemente del modo en el que se encuentre.
-Use estos atajos al editar en modo visual.
+Use estos atajos cuando edite en el modo visual.
@@ -49,17 +47,19 @@ Use estos atajos al editar en modo visual.
-### Encabezados
+### Títulos
| Comando | macOS | Windows |
| :--- | :--- | :--- |
| **Texto** | Cmd + Option + 0 | Ctrl + Alt + 0 |
-| **Encabezado 1** | Cmd + Option + 1 | Ctrl + Alt + 1 |
-| **Encabezado 2** | Cmd + Option + 2 | Ctrl + Alt + 2 |
-| **Encabezado 3** | Cmd + Option + 3 | Ctrl + Alt + 3 |
-| **Encabezado 4** | Cmd + Option + 4 | Ctrl + Alt + 4 |
+| **Título 1** | Cmd + Option + 1 | Ctrl + Alt + 1 |
+| **Título 2** | Cmd + Option + 2 | Ctrl + Alt + 2 |
+| **Título 3** | Cmd + Option + 3 | Ctrl + Alt + 3 |
+| **Título 4** | Cmd + Option + 4 | Ctrl + Alt + 4 |
+| **Título 5** | Cmd + Option + 5 | Ctrl + Alt + 5 |
+| **Título 6** | Cmd + Option + 6 | Ctrl + Alt + 6 |
@@ -69,7 +69,7 @@ Use estos atajos al editar en modo visual.
| Comando | macOS | Windows |
| :--- | :--- | :--- |
-| **Lista con viñetas** | Cmd + Shift + 8 | Ctrl + Shift + 8 |
+| **Lista sin ordenar** | Cmd + Shift + 8 | Ctrl + Shift + 8 |
| **Cita en bloque** | Cmd + Shift + B | Ctrl + Shift + B |
-El modo source usa el editor Monaco, que admite los atajos de teclado estándar de VS Code.
+El modo source usa CodeMirror. Funcionan la mayoría de los atajos habituales de los editores de código, además de los que aparecen a continuación.
@@ -80,10 +80,10 @@ Use estos atajos al editar en modo visual.
| Comando | macOS | Windows |
| :--- | :--- | :--- |
-| **Añadir enlace** al texto seleccionado | Cmd + K | Ctrl + K |
-| **Insertar salto de línea** | Cmd + Enter | Ctrl + Enter |
+| **Añadir un enlace** al texto seleccionado | Cmd + K | Ctrl + K |
+| **Añadir un salto de línea** | Cmd + Enter | Ctrl + Enter |
| **Comentar el texto resaltado** | Cmd + Shift + M | Ctrl + Shift + M |
-| **Alternar el modo de sugerencias** | Cmd + Shift + E | Ctrl + Shift + E |
+| **Activar o desactivar el modo de sugerencias** | Cmd + Shift + E | Ctrl + Shift + E |
| **Menú de componentes** | / | / |
| **Selector de emojis** | : + palabra clave | : + palabra clave |
@@ -93,9 +93,9 @@ Use estos atajos al editar en modo visual.
-El editor convierte automáticamente ciertas secuencias de caracteres en símbolos tipográficos a medida que escribe. El editor omite las sustituciones dentro de bloques de código y código en línea.
+El editor convierte automáticamente ciertas secuencias de caracteres en símbolos tipográficos mientras escribe. El editor omite las sustituciones dentro de los bloques de código y del código en línea.
-| Tipo | Resultado |
+| Escriba | Resultado |
| :--- | :--- |
| `->` | → |
| `<-` | ← |
@@ -110,7 +110,7 @@ El editor convierte automáticamente ciertas secuencias de caracteres en símbol
@@ -121,7 +121,7 @@ El modo source usa el editor Monaco, que admite los atajos de teclado estándar
| Comando | macOS | Windows |
| :--- | :--- | :--- |
| **Buscar archivos** | Cmd + K | Ctrl + K |
-| **Buscar** | Cmd + F | Ctrl + F |
+| **Buscar en la página** | Cmd + F | Ctrl + F |
@@ -131,12 +131,16 @@ El modo source usa el editor Monaco, que admite los atajos de teclado estándar
| Comando | macOS | Windows |
| :--- | :--- | :--- |
-| **Comentar/descomentar** | Cmd + / | Ctrl + / |
-| **Indentar línea** | Tab | Tab |
-| **Quitar sangría de la línea** | Shift + Tab | Shift + Tab |
-| **Mover línea hacia arriba** | Option + ↑ | Alt + ↑ |
-| **Mover línea hacia abajo** | Option + ↓ | Alt + ↓ |
-| **Duplicar línea** | Shift + Option + ↓ | Shift + Alt + ↓ |
+| **Negrita** (envuelve en `**`) | Cmd + B | Ctrl + B |
+| **Cursiva** (envuelve en `_`) | Cmd + I | Ctrl + I |
+| **Comentar o descomentar** | Cmd + / | Ctrl + / |
+| **Plegar todo** | Cmd + Option + Shift + [ | Ctrl + Alt + Shift + [ |
+| **Desplegar todo** | Cmd + Option + Shift + ] | Ctrl + Alt + Shift + ] |
+| **Aumentar la sangría de la línea** | Tab | Tab |
+| **Reducir la sangría de la línea** | Shift + Tab | Shift + Tab |
+| **Subir la línea** | Option + ↑ | Alt + ↑ |
+| **Bajar la línea** | Option + ↓ | Alt + ↓ |
+| **Duplicar la línea** | Shift + Option + ↓ | Shift + Alt + ↓ |
- La vista previa en vivo funciona en sitios públicos y en sitios protegidos con autenticación de Mintlify. En sitios autenticados, el editor inicia sesión automáticamente en la vista previa.
-
-
-
-
- 
-
-
-
- Algunos elementos no pueden anidarse dentro de otros. Por ejemplo, las pestañas no pueden anidarse dentro de grupos. El editor te impide crear combinaciones no válidas.
-
-
-
-
-Elige la estructura adecuada para tu contenido:
-
-- **Pages**—Archivos individuales de documentación. El bloque de construcción principal de la navegación.
-- **Groups**—Secciones plegables que agrupan páginas relacionadas. Pueden anidarse dentro de otros grupos.
-- **Tabs**—Secciones de nivel superior con navegación horizontal en la parte superior del sitio. Úsalas cuando tengas áreas distintas como API Reference y Guides.
-- **Anchors**—Elementos persistentes en la parte superior de la barra lateral. Útiles para acceder rápidamente a recursos externos o secciones de nivel superior. Pueden ser globales para aparecer en todas las páginas.
-- **Dropdowns**—Menús desplegables en la parte superior de la barra lateral. Una alternativa más ligera a las pestañas para varias secciones relacionadas.
-- **Menus**—Elementos de navegación desplegables dentro de una pestaña para enlazar directamente con páginas específicas.
-- **Products**—Un selector para varios conjuntos de documentación de productos distintos, cada uno con su propia estructura de navegación.
-- **Versions**—Un selector para varias versiones simultáneas de la documentación.
-- **Languages**—Un selector para documentación en varios idiomas.
-
-
@@ -144,8 +148,12 @@ El modo source usa el editor Monaco, que admite los atajos de teclado estándar
+{/* vale Mintlify.WordList = NO */}
+
| Comando | macOS | Windows |
| :--- | :--- | :--- |
-| **Añadir cursor** | Option + clic | Alt + clic |
-| **Añadir cursor encima** | Cmd + Option + ↑ | Ctrl + Alt + ↑ |
-| **Añadir cursor debajo** | Cmd + Option + ↓ | Ctrl + Alt + ↓ |
+| **Añadir un cursor** | Option + clic | Alt + clic |
+| **Añadir un cursor arriba** | Cmd + Option + ↑ | Ctrl + Alt + ↑ |
+| **Añadir un cursor abajo** | Cmd + Option + ↓ | Ctrl + Alt + ↓ |
+
+{/* vale Mintlify.WordList = YES */}
diff --git a/es/editor/live-preview.mdx b/es/editor/live-preview.mdx
deleted file mode 100644
index 8c52e6493..000000000
--- a/es/editor/live-preview.mdx
+++ /dev/null
@@ -1,69 +0,0 @@
----
-title: "Vista previa en vivo"
-description: "Previsualice su sitio en tiempo real mientras edita, con actualizaciones continuas que renderizan al instante los cambios de contenido y configuración."
-keywords: ["editor", "preview", "live preview"]
----
-
-Previsualice su sitio mientras edita. Las vistas previas en vivo renderizan las páginas exactamente como se ven cuando se publican. Se actualizan a medida que realiza cambios en el contenido, la navegación y la configuración.
-
-
-
-## Abrir la vista previa en vivo
-
-
-
-Haga clic en el botón
-
-
-
-
-
-## Editar la configuración del sitio en la vista previa en vivo
-
-
-
-Edite la configuración del sitio en la vista previa en vivo para ver cómo afecta al contenido renderizado.
-
-1. Abra la vista previa en vivo dentro del editor.
-2. Haga clic en **Site settings** en la barra de herramientas de la vista previa.
-3. Seleccione una sección de configuración y edite sus opciones.
-
-Si configura la vista previa en vivo para que se abra en una nueva pestaña, el menú de configuración del sitio no estará disponible. Desactive **Open live preview in new tab** en la [configuración del editor](/es/editor/settings) para usar el menú de configuración del sitio.
-
-
-
-## Preguntar al agente en la vista previa en vivo
-
-
-
-Haga clic en **Ask agent** en la barra de herramientas de la vista previa para abrir el [agente del editor](/es/editor/agent) junto a la vista previa en vivo. Solo los editores y administradores pueden usar el agente en las vistas previas en vivo.
-
-
-
-## Vista previa en vivo frente a despliegues de vista previa
-
-
-
-| | Vista previa en vivo | Despliegue de vista previa |
-|---|---|---|
-| **Velocidad** | Al instante | Requiere una compilación |
-| **Acceso** | URL local, con autenticación automática para sitios protegidos | URL para compartir |
-| **Cuándo usarla** | Para revisar cambios mientras edita | Para compartir con su equipo para su revisión |
-| **Disponibilidad** | Mientras el editor esté abierto | Mientras exista la branch |
-
-Use la vista previa en vivo para obtener retroalimentación inmediata mientras edita. Cuando necesite compartir cambios con su equipo, use un [despliegue de vista previa](/es/editor/branching-and-publishing#preview-your-changes). También puede usarlo para probar los cambios en un dispositivo diferente.
diff --git a/es/editor/media.mdx b/es/editor/media.mdx
deleted file mode 100644
index 090a82afd..000000000
--- a/es/editor/media.mdx
+++ /dev/null
@@ -1,100 +0,0 @@
----
-title: "Agregar contenido multimedia"
-description: "Sube, gestiona e inserta imágenes y otros recursos multimedia en tus páginas de documentación usando el gestor de archivos integrado del editor web de Mintlify."
-keywords: ["editor","media","images","assets"]
----
-
-
- ## Tipos de archivo admitidos
-
-
-* **Imágenes**: PNG, JPG, JPEG, GIF, WebP (máx. 20 MB)
-* **Vídeos**: MP4, WebM (máx. 20 MB)
-* **Fuentes**: TrueType (TTF), WOFF, WOFF2
-* **Otros**: PDF, ICO (favicons)
-
-
- ## Agregar contenido multimedia a una página
-
-
-
- ### Arrastrar y soltar
-
-
-Arrastra y suelta contenido multimedia desde tu computadora o desde el gestor de recursos sobre una página. En modo visual, la imagen o el video se insertan en línea. En Modo Markdown, el editor inserta la ruta en la posición de tu cursor. Las imágenes se guardan en la raíz de tu carpeta `images/`, y los videos se guardan en la raíz de tu carpeta `videos/`.
-
-
- ### Comando slash
-
-
-Escribe /image para abrir el menú de imágenes o /video para abrir el menú de vídeos. Sube contenido multimedia nuevo o selecciona entre los archivos existentes.
-
-
- ### Incrustar
-
-
-Escribe /embed y pega una URL de YouTube, Loom o Vimeo. El editor detecta el proveedor y genera el iframe automáticamente. Al buscar en el menú slash, los términos `youtube`, `yt`, `loom` y `vimeo` también muestran el comando **Embed**.
-
-Para otras incrustaciones, escribe /embed y activa **Inserción manual** para escribir HTML personalizado.
-
-
- ### Subir archivos
-
-
-Usa el explorador de archivos en la barra lateral para subir o buscar archivos. Arrastra y suelta archivos en una carpeta para organizar recursos multimedia.
-
-
-
-
-
-
-
-
- ## Formatear imágenes
-
-
-Después de insertar una imagen en el modo visual, pasa el cursor por encima para mostrar una barra de herramientas con opciones de formato.
-
-- **Vista previa en modo claro/oscuro**: Cambia entre el modo claro y oscuro para ver cómo se ve la imagen en cada tema.
-- **Alineación**: Establece la alineación de la imagen como izquierda, centrada, derecha o a todo el ancho.
-- **Frame**: Envuelve la imagen en un componente `` para añadir un borde y un fondo.
-- **Configuración**: Reemplaza la imagen o actualiza su texto alternativo.
-
-
- ## Administra los recursos
-
-
-
- ### Organiza con carpetas
-
-
-Haz clic en el botón **+** del explorador de archivos para crear una nueva carpeta. Arrastra y suelta archivos y carpetas en el árbol de archivos para reordenarlos.
-
-
- ### Renombrar y editar recursos
-
-
-Pasa el cursor sobre un recurso y haz clic en el botón **...** para cambiar el nombre del archivo o actualizar su texto alternativo (alt).
-
-
- ### Eliminar recursos
-
-
-Pasa el cursor sobre un recurso y haz clic en el botón
- ## Mejores prácticas
-
-
-- **Usa nombres descriptivos**: Pon nombres claros a los archivos, como `api-dashboard-light.png` en lugar de `img1.png`.
-- **Agrega texto alternativo (alt text)**: Proporciona texto alternativo descriptivo para mejorar la accesibilidad y el SEO.
-- **Organiza con carpetas**: Agrupa los recursos relacionados, como variantes de modo claro y oscuro o recursos para un área de funcionalidad específica.
-- **Usa formatos apropiados**: PNG para gráficos con transparencia, JPG para fotos, SVG para iconos y logotipos (no puedes subir archivos SVG a través del editor, pero puedes agregarlos a tu repositorio mediante Git).
\ No newline at end of file
diff --git a/es/editor/navigation.mdx b/es/editor/navigation.mdx
deleted file mode 100644
index b98f313b7..000000000
--- a/es/editor/navigation.mdx
+++ /dev/null
@@ -1,49 +0,0 @@
----
-title: "Organizar la navegación"
-description: "Reordena páginas, agrega grupos y gestiona la barra lateral de tu documentación con arrastrar y soltar en el editor web de Mintlify, sin tocar docs.json."
-keywords: ["editor", "navigation", "sidebar", "structure"]
----
-
-Usa la barra lateral de navegación para organizar tu documentación. Los cambios que realices en el editor se sincronizan con tu repositorio cuando publicas: no necesitas editar `docs.json` manualmente.
-
-
-
-Haz clic en **Add new** en la parte inferior del árbol de navegación para añadir un nuevo elemento en el nivel raíz. Para añadir un elemento anidado dentro de otro, haz clic en el botón
- ## Configurar elementos
-
-
-Pasa el cursor sobre cualquier elemento de navegación y haz clic en el icono de engranaje para definir:
-
-- **Title**: La etiqueta que se muestra en la barra lateral.
-- **Icon**: Un marcador visual junto a la etiqueta.
-- **Tag**: Una insignia como "NEW" o "BETA" para destacar el elemento.
diff --git a/es/editor/pages.mdx b/es/editor/pages.mdx
index 1887f52d8..c5e0c9be9 100644
--- a/es/editor/pages.mdx
+++ b/es/editor/pages.mdx
@@ -1,246 +1,94 @@
---
title: "Crear y editar páginas"
-description: "Cree páginas, edite contenido, suba imágenes y vídeos y administre archivos en el editor web de Mintlify con edición enriquecida y búsqueda global."
-keywords: ["editor", "content", "pages", "files", "create", "edit", "version history", "media", "images", "video", "task lists", "private pages"]
+sidebarTitle: "Editar contenido"
+description: "Cree páginas, edite contenido, añada archivos multimedia, organice su navegación y recupere versiones anteriores de una página en el editor."
+keywords: ["editor", "content", "pages", "navigation", "version history", "media", "images", "private pages"]
---
-
+
-## Navegar por archivos
+## Home y Publishing
-El panel izquierdo tiene dos vistas: **Navigation** y **Files**.
+El espacio de trabajo del editor se divide en dos pestañas: **Home** y **Publishing**.
-**Navigation** muestra la estructura de su barra lateral tal como la ven los visitantes. Haga clic en una página para abrirla.
+**Home** es su espacio de trabajo. Muestra los archivos de contenido de su repositorio, incluidas sus páginas privadas, aparezcan o no en su sitio publicado.
-**Files** muestra el árbol de archivos completo de su repositorio, incluidos los archivos que no están en su navegación. Haga clic en cualquier archivo para abrirlo.
+**Publishing** es su sitio publicado. Muestra la navegación que ven sus visitantes, junto con la configuración de su sitio.
-Para alternar entre vistas, haga clic en el icono
+
-## Administrar archivos y carpetas
+## Crear una página
-Use la vista Files para organizar su contenido:
+Para añadir una página a su navegación, haga clic en el botón
-
-## Crear páginas nuevas
-
-
-
-
+
-### Añadir una página a la navegación
+## Añadir archivos multimedia
-1. Haga clic en el botón
-
-### Crear una página no listada
-
-
+Escriba /image o /video para subir un archivo o elegir uno que ya esté en su repositorio. También puede arrastrar archivos desde su equipo hasta la página. Para reutilizar un archivo multimedia, arrastre una imagen o un vídeo desde el árbol de navegación hasta una página.
-Las páginas no listadas existen en su repositorio pero no aparecen en la navegación. Son útiles para contenido en borrador, fragmentos reutilizables o páginas que planea añadir a la navegación más adelante.
+- Los archivos subidos se guardan en sus carpetas `images/` y `videos/` y se incluyen en el commit de su próxima publicación.
+- Los formatos admitidos son PNG, JPG, JPEG, GIF, WebP, SVG, MP4 y WebM.
+- Para mostrar imágenes distintas en modo claro y oscuro, pase el cursor sobre una imagen insertada y use **Light/dark variants**.
+- Escriba /embed y pegue una URL de YouTube, Loom o Vimeo para generar el iframe. Para cualquier otro caso, active **Manual embed** y escriba HTML personalizado.
-Haga clic con el botón derecho en cualquier carpeta de la vista Files y seleccione **New file**. Introduzca un nombre de archivo y el editor crea la página sin añadirla a la navegación. Puede añadirla a la navegación más tarde desde la pestaña **Navigation**.
+Para dar formato a las imágenes y usar el componente Frame, consulte [Imágenes e incrustaciones](/es/create/image-embeds).
-
+
-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
+ Algunos elementos no pueden anidarse dentro de otros. Por ejemplo, las tabs no pueden anidarse dentro de groups. El editor impide las combinaciones no válidas.
+
-También puede abrir un diff desde el menú de publicación. Haga clic en **Publish** y luego en cualquier archivo modificado de la lista.
+Para cambiar el título, el slug, la descripción o el layout de una página, abra su configuración desde el árbol de navegación. Consulte [Páginas](/es/organize/pages) para obtener más información sobre cada ajuste.
-
-### Vista de diff
-
-
+- **Groups**: Secciones plegables que agrupan páginas relacionadas. Pueden anidarse dentro de otros groups.
+- **Tabs**: Secciones de nivel superior con navegación horizontal. Úselas para áreas diferenciadas, como una referencia de API y guías.
+- **Anchors**: Elementos persistentes en la parte superior de su barra lateral. Útiles para recursos externos. Pueden ser globales y aparecer en todas las páginas.
+- **Dropdowns**: Menús desplegables en la parte superior de su barra lateral. Una alternativa más ligera que las tabs.
+- **Menus**: Elementos desplegables dentro de una tab que enlazan directamente con páginas concretas.
+- **Products**: Un selector para varios conjuntos de documentación de producto, cada uno con su propia navegación.
+- **Versions**: Un selector para varias versiones simultáneas de la documentación.
+- **Languages**: Un selector para documentación en varios idiomas.
-Para comparar su página actual con la última versión publicada, haga clic en el botón
-### Historial de versiones
+## Historial de versiones
-Use el historial de versiones para revisar las versiones guardadas de la página que está editando.
+El historial de versiones le permite revisar y restaurar versiones guardadas anteriores de una página. No está disponible para `docs.json`.
-Mint registra una nueva entrada cuando el editor guarda contenido diferente de la última versión registrada. Guardar contenido sin cambios no crea una entrada duplicada. Una página guardada también puede estar vacía.
+Los viewers pueden revisar y comparar las versiones guardadas de las páginas privadas. Los editors y admins pueden restaurarlas.
-El historial de versiones agrupa las entradas por fecha. Cada entrada muestra el autor y la hora de guardado. Mint marca la entrada más reciente como **Current**.
+El editor registra una entrada nueva siempre que el contenido difiere de la última versión registrada. El historial de versiones está limitado a la branch actual. Solo está disponible el historial de la branch en la que trabaja.
-Para abrir el historial de versiones:
+Para ver el historial de versiones, haga clic en
-El panel muestra las versiones de la página actual. El historial de las páginas públicas solo incluye la rama actual. El historial de las páginas privadas incluye entradas de todas las ramas. Haga clic en **Show more versions** para cargar entradas anteriores.
-
-Los viewers pueden revisar y comparar las versiones guardadas de las páginas privadas. Los editors y managers pueden restaurarlas. Las versiones anteriores incluyen la acción **Restore** cuando tiene permiso para editar la página. Haga clic en **Restore** y confirme para reemplazar el contenido actual de la página con esa versión guardada. Esta acción sobrescribe los cambios sin guardar.
-
-Restore aplica la instantánea seleccionada a la página actual. En las páginas públicas, restaura la página en la rama actual. En las páginas privadas, actualiza el contenido privado compartido.
-
-Para comparar una versión guardada anterior con la página actual, haga clic en su fila. El editor abre la vista de diff con la versión guardada como base y el contenido actual de la página como comparación. La fila muestra **Viewing** mientras está activa. Haga clic de nuevo en la fila activa para salir de la comparación y volver a la edición.
-
-Restore no está disponible en ramas de despliegue bloqueadas ni en la versión **Current**.
-
-
-
-
-
-
- No puede mover contenido del workspace de vuelta a la sección **Private**.
+ No puede mover contenido del workspace de vuelta a la sección **Private**. Hacer pública una página privada es un cambio irreversible.
-
-
- Cuando creas una solicitud de extracción desde el editor, el agente de Mintlify genera un título y una descripción en función de tus cambios. Puedes editar el título y la descripción generados antes de crear la solicitud de extracción.
-
-
-**Publicar directamente**: Si tu repositorio no tiene reglas de protección de branch, tus cambios se fusionan en la rama de implementación y se implementan de inmediato cuando publicas.
+
+ Si no ve un selector de branch ni un botón **Publish**, su deployment tiene activada la [publicación automática](#auto-publish) y sus ediciones se publican automáticamente.
+
-| Tipo de branch | Protección de branch | Flujo de publicación |
-|-------------|-------------------|------------------------------|
-| Rama de implementación | Ninguna | Realiza una confirmación e implementa los cambios |
-| Rama de implementación | Solicitudes de extracción obligatorias | Crea una solicitud de extracción |
-| Branch de funcionalidad | Ninguna | Fusiona los cambios en la rama de implementación e implementa los cambios |
-| Branch de funcionalidad | Solicitudes de extracción obligatorias | Crea una solicitud de extracción |
+
-
-### Acciones de bloque
+## Páginas privadas
-En modo visual, pase el cursor sobre cualquier bloque para mostrar un controlador de arrastre a la izquierda. Haga clic en el controlador para abrir un menú contextual con acciones para ese bloque:
-
-- **Turn into**: Convierte el bloque en otro tipo: texto, encabezados, cita en bloque o lista.
-- **Duplicate**: Inserta una copia del bloque inmediatamente después.
-- **Delete**: Elimina el bloque.
-
-
-
-
-
-
-
-
-### Índice de contenido
-
-
-
-En modo visual, el editor muestra un minimapa en el lado derecho de la página que refleja la estructura de encabezados de su documento. Pase el cursor sobre el minimapa para expandirlo en un índice de contenido completo. Haga clic en cualquier encabezado para desplazarse a esa sección.
-
-
-
-### Opciones de los bloques de código
-
-
-
-Al editar un bloque de código en modo visual, puede:
-
-- **Resaltar o enfocar líneas**: Seleccione texto dentro del bloque de código y luego use la barra de herramientas que aparece para marcar líneas como resaltadas o enfocadas. Resaltar enfatiza visualmente las líneas. Enfocar líneas atenúa todo lo demás.
-- **Marcar líneas de diff**: Seleccione líneas y use la barra de herramientas para marcarlas como adiciones (`+`) o eliminaciones (`-`).
-- **Wrap**: Alterna el ajuste de línea en la configuración del bloque de código.
-- **Expandable**: Hace que el bloque de código sea contraíble para que los lectores puedan expandirlo cuando lo deseen.
-
-
-
-## Administrar páginas
-
-
-
-- **Mover**: Arrastre y suelte las páginas para reordenarlas en la navegación.
-- **Renombrar**: Haga clic con el botón derecho en una página y seleccione **Rename**.
-- **Duplicar**: Haga clic con el botón derecho en una página y seleccione **Duplicate**.
-- **Eliminar**: Haga clic con el botón derecho en una página y seleccione **Delete**. El editor quita la página de la navegación automáticamente.
-
-### Mover páginas privadas al workspace
-
-Para convertir una página o carpeta privada en contenido del workspace, arrastre el contenido privado desde la sección **Private** a una carpeta de su workspace. También puede hacer clic con el botón derecho sobre el contenido privado y seleccionar **Move to workspace**.
-
-Cuando mueve una carpeta privada, todas las páginas de la carpeta se mueven a su workspace. Cualquier contenido que mueva al workspace queda disponible de inmediato para los colaboradores del workspace, pero no se añade a la navegación del sitio.
+Arrastrar una página o carpeta privada a su workspace la pone a disposición de sus colaboradores de inmediato, aunque no se añade a la navegación de su sitio.
-
-### Páginas eliminadas mediante Git
-
-
-
-Si un compañero de equipo elimina una página a través de Git mientras la tiene abierta, el editor entra en modo de solo lectura y muestra una barra de aviso. El editor conserva su contenido para que pueda copiarlo antes de salir de la página.
-
-
-
-## Configurar páginas
-
-
-
-Pase el cursor sobre una página y haga clic en el icono de engranaje, o haga clic con el botón derecho y seleccione **Settings**, para configurar:
-
-- **Title**, **Slug** y **Sidebar title**: Controlan cómo aparece la página en la navegación y su URL.
-- **Description** y **Keywords**: Mejoran la búsqueda y el SEO.
-- **Layout**: Elija entre estándar, ancho, centrado o personalizado.
-
-Para más detalles sobre cada ajuste, consulte [Pages](/es/organize/pages).
-
-
-
-## Añadir medios
-
-
-
-
-
-### Imágenes y vídeos
-
-
-
-Escriba /image para subir una nueva imagen o seleccionar una existente de su repositorio. Escriba /video para subir o seleccionar un vídeo.
-
-También puede arrastrar y soltar archivos desde su ordenador directamente sobre una página. En modo visual, el archivo se inserta en línea. En modo source, el editor inserta la ruta del archivo en la posición del cursor. Las imágenes se guardan en su carpeta `images/` y los vídeos en `videos/`.
-
-Para reutilizar medios que ya existen en su proyecto, arrastre un archivo de imagen o vídeo desde el árbol de navegación a la página. El editor incrusta el activo en línea.
-
-
-
-### Variantes de imagen claras y oscuras
-
-
-
-Después de insertar una imagen en modo visual, pase el cursor sobre ella para mostrar la barra de herramientas de imagen. Use **Light/dark variants** para subir imágenes separadas para modo claro y oscuro.
-
-
-
-### Incrustar medios externos
-
-
-
-Escriba /embed y pegue una URL de YouTube, Loom o Vimeo. El editor detecta el proveedor y genera el iframe. Buscar `youtube`, `yt`, `loom` o `vimeo` en el menú de barra inclinada también muestra el comando **Embed**.
-
-Para otras incrustaciones, escriba /embed y active **Manual embed** para escribir HTML personalizado.
-
-Para más información sobre el formato de imágenes y el uso del componente Frame, consulte [Images and embeds](/es/create/image-embeds).
diff --git a/es/editor/publish.mdx b/es/editor/publish.mdx
index a1b920f92..0d0cbf40b 100644
--- a/es/editor/publish.mdx
+++ b/es/editor/publish.mdx
@@ -1,108 +1,96 @@
---
-title: "Publicar cambios en el editor web"
+title: "Publicar cambios"
sidebarTitle: "Publicar"
-description: "Guarda tu trabajo, gestiona branches y pull requests, y publica los cambios desde el editor web a tu sitio de documentación en producción."
-keywords: ["editor", "publicar", "cambios", "branches", "solicitudes de extracción"]
+description: "Publique cambios desde el editor en su sitio publicado. Las branches y las reglas de protección determinan qué ocurre cuando publica."
+keywords: ["publish", "branch", "git", "commit", "conflicts", "deploy", "pull request"]
---
-
- ## Flujos de publicación
-
-
-El editor admite dos flujos de trabajo para publicar actualizaciones de la documentación. El flujo que uses depende de las reglas de protección de branch de tu repositorio y de la branch en la que trabajes.
-
-**Crear solicitudes de extracción**: Si tu repositorio tiene una regla de protección de branch que requiere solicitudes de extracción antes de que los cambios se puedan fusionar en tu rama de implementación, el editor crea una solicitud de extracción cuando publicas cambios.
+Sus cambios se guardan automáticamente mientras edita, pero solo llegan a su sitio publicado cuando los publica. Lo que ocurre al publicar depende de en qué branch trabaja y de si esa branch requiere pull requests.
-
-
- Configura reglas de protección de branch en tu proveedor de Git para requerir solicitudes de extracción. Consulta [Acerca de las ramas protegidas](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches) en la documentación de GitHub o [Ramas protegidas](https://docs.gitlab.com/user/project/repository/branches/protected/) en la documentación de GitLab.
-
+## Cambios pendientes
-
- 
-
+Deployment branch | Ninguna | **Publish** directamente en su sitio publicado |
+| Deployment branch | Requiere pull requests | **Create branch** para mover los cambios a una branch nueva |
+| Feature branch | Ninguna | **Save in branch**, **Create pull request** |
+| Feature branch | Requiere pull requests | **Save in branch**, **Create pull request** |
-
+ Su sitio se actualiza después de que Mintlify compile y despliegue sus cambios. Esto suele tardar entre 30 segundos y unos minutos. Consulte el estado del despliegue en su [dashboard](https://app.mintlify.com).
+
-Haz clic en un archivo de la lista para abrir una vista de diferencias que muestra los cambios entre la branch y el contenido publicado. Los archivos de documentación se abren en un diff visual, y otros tipos de archivos se abren en un diff de código fuente. Usa esto para revisar el alcance completo de los cambios en una branch antes de publicar.
+
- ## Guardar cambios
-A medida que editas, el editor realiza un seguimiento de tus cambios.
+El editor registra lo siguiente como cambios pendientes:
-- Archivos nuevos o eliminados.
-- Ediciones de contenido en las páginas.
-- Cambios en la estructura de navegación.
-- Cargas y organización de archivos multimedia.
-- Actualizaciones de configuración.
+- Ediciones de contenido en páginas
+- Páginas nuevas o eliminadas
+- Cambios en la estructura de navegación
+- Archivos multimedia subidos
+- Actualizaciones de configuración
-Cuando trabajas en tu rama de implementación, los cambios se guardan automáticamente.
+Si no hay cambios pendientes, el editor deshabilita las acciones de publicar y guardar.
-
-
-
-
+
-Cuando trabajas en una rama de funcionalidad, guarda los cambios en la rama.
+## Qué ocurre cuando publica
-
-
-
-
+
-Para descartar cambios, haz clic en **Undo changes** junto al nombre de un archivo en el menú desplegable de archivos modificados.
+| Tipo de branch | Protección de branch | Acciones disponibles |
+| --- | --- | --- |
+|
-
-
+
- ## Revisar los cambios de una branch
-
+- **Publish**: Hace commit y despliega sus cambios en su sitio publicado de inmediato.
+- **Save in branch**: Hace commit de sus cambios en la feature branch sin hacer merge en su deployment branch.
+- **Create branch**: Mueve sus cambios pendientes a una feature branch nueva cuando está en una deployment branch protegida.
+- **Create pull request**: Abre una pull request dirigida a su deployment branch.
+
+Solo puede realizarse una publicación a la vez por branch. Si un compañero publica en la misma branch, espere a que termine su publicación antes de volver a intentarlo.
-Cuando trabajas en una branch de funcionalidad, el panel de publicación muestra todos los cambios de archivos entre tu branch y la rama de implementación en **Saved in branch**. Esto incluye los cambios guardados por ti y los de cualquier compañero que trabaje en la misma branch.
+
-Los archivos que no pueden mostrar un diff, como imágenes o archivos eliminados, aparecen en la lista pero no son seleccionables.
+## Cuándo usar una branch
-
- Tu sitio de documentación en producción se actualiza después de que Mintlify compila e implementa tus cambios publicados. Esto suele tardar entre 30 segundos y unos pocos minutos. Consulta el estado de implementación de tus cambios en tu [dashboard](https://dashboard.mintlify.com).
+ Crear o cambiar de branch mientras tiene cambios sin publicar le pide que decida si quiere llevarlos consigo o dejarlos atrás. Los cambios que deja atrás permanecen en la branch original.
-## Resolver conflictos
+
- ## Publica tus cambios
-Haz clic en **Publish** en la barra de herramientas. Según tu flujo de trabajo, tus cambios se implementan de inmediato o se crea una solicitud de extracción para que la fusiones en tu proveedor de Git. Si estás en una branch de funcionalidad, guarda tus cambios antes de publicar.
+Edite directamente en su deployment branch si no usa un flujo de trabajo basado en Git. Cree una branch si cada cambio pasa por una revisión antes de llegar a su sitio publicado.
-Si no hay cambios pendientes o ya hay una solicitud de extracción abierta para la branch actual, no se puede hacer clic en el botón **Publish**.
+Para crear una branch, haga clic en el nombre de la branch en la barra de herramientas del editor, seleccione **Create new branch**, escriba un nombre y haga clic en **Create branch**.
-Los conflictos se producen cuando tu branch y la rama de implementación contienen cambios incompatibles en los mismos archivos.
+## Resolver conflictos
-
- ### Qué provoca los conflictos
-Los conflictos se producen cuando intentas fusionar branches con cambios incompatibles en los mismos archivos.
+Los conflictos se producen cuando su branch y la deployment branch tienen cambios incompatibles en los mismos archivos. Por ejemplo, cuando usted y un compañero editan las mismas líneas o mueven un archivo a ubicaciones distintas.
-* Tú y otra persona del equipo modifican las mismas líneas de un archivo en distintas branches.
-* Los archivos se mueven, renombran o eliminan en una branch, pero se modifican de otra forma en otra.
+Cuando alguien hace push a su repositorio desde fuera del editor, el editor aplica automáticamente los cambios que no se solapan. Si un cambio remoto y su edición afectan a la misma parte de una página, el editor resalta el conflicto.
+
+El editor muestra una advertencia cuando los conflictos impiden publicar. Siga las indicaciones para elegir qué versión de cada sección en conflicto quiere conservar.
+
+
+
+## Firma de commits
-
- ### Resolver conflictos
-El editor muestra advertencias cuando los conflictos impiden realizar operaciones como publicar o cambiar de branch. Para resolverlos, sigue las instrucciones del editor para elegir qué cambios conservar.
+Firme los commits con su cuenta de GitHub autorizándola en la [configuración de su cuenta](https://app.mintlify.com/settings/account). Sin esa autorización, la GitHub App de Mintlify firma los commits hechos en el editor.
+
+
+
+## Publicación automática
-
+ La vista previa en vivo funciona en sitios públicos y en sitios protegidos con la autenticación de Mintlify.
+
+
+
+ 
+
+
+Las URLs de vista previa son públicas de forma predeterminada. Para restringir el acceso a los miembros de su organización de Mintlify, active la autenticación de vistas previa en la página [Add-ons](https://app.mintlify.com/products/addons) de su dashboard.
+
+
+ Configure reglas de protección de branch en su proveedor de Git para exigir pull requests. Consulte [About protected branches](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches) en la ayuda de GitHub o [Protected branches](https://docs.gitlab.com/user/project/repository/branches/protected/) en la ayuda de GitLab.
+
+
+
- ## Firma de confirmaciones
-Firma tus confirmaciones con tu cuenta de GitHub al autorizarla en la [configuración de la cuenta](https://dashboard.mintlify.com/settings/account). Sin autorización, la Aplicación de GitHub de Mintlify firma las confirmaciones realizadas en el editor web.
+Si su deployment tiene activada la [publicación automática](/es/editor/settings#main-branch-autocommits), el editor hace commit en su deployment branch poco después de que deje de escribir. El selector de branch y el botón **Publish** quedan ocultos. No hay estado pendiente ni paso de revisión.
-Asociar las confirmaciones a tu cuenta mantiene un historial preciso de quién hizo cambios en tu documentación.
\ No newline at end of file
+Las ediciones en feature branches creadas desde el editor se confirman automáticamente en cualquier caso, pero nunca se publican a menos que haga merge en su deployment branch.
diff --git a/es/editor/review.mdx b/es/editor/review.mdx
new file mode 100644
index 000000000..633ab1d09
--- /dev/null
+++ b/es/editor/review.mdx
@@ -0,0 +1,131 @@
+---
+title: "Revisar cambios"
+sidebarTitle: "Revisar"
+description: "Previsualice los cambios antes de publicarlos, compártalos con su equipo y apruebe y haga merge de pull requests desde el editor."
+keywords: ["review", "preview", "live preview", "pull request", "approve", "merge", "diff"]
+---
+
+Previsualice sus cambios antes de que lleguen a su sitio publicado y, después, revise y haga merge de la pull request sin salir del editor.
+
+
+
+## Vista previa en vivo
+
+
+
+La vista previa en vivo representa su sitio mientras edita, sin ningún paso de compilación. Haga clic en el botón
+
+## Despliegues de vista previa
+
+
+
+Cuando abre una pull request desde una feature branch, Mintlify compila un despliegue de vista previa: una URL temporal donde sus cambios se representan exactamente como se verán al publicarse. La vista previa se vuelve a compilar cada vez que guarda cambios nuevos en la branch.
+
+Para encontrar y compartir la URL, haga clic en **Publish** en la barra de herramientas. El formato de la URL es `organization-branch-name.mintlify.site`.
+
+
+
+
+
+
+Las URLs de vista previa son públicas de forma predeterminada. Para restringir el acceso a los miembros de su organización de Mintlify, active la autenticación de vistas previa en la página [Add-ons](https://app.mintlify.com/products/addons) de su dashboard.
+
+
+
+## Qué vista previa usar
+
+
+
+| | Vista previa en vivo | Despliegue de vista previa |
+|---|---|---|
+| **Velocidad** | Instantánea | Requiere una compilación |
+| **Acceso** | URL local | URL para compartir |
+| **Úsela cuando** | Revisa cambios mientras edita | Comparte con su equipo para revisión |
+| **Disponibilidad** | Mientras el editor está abierto | Mientras exista la branch |
+
+
+
+Para dirigir a un compañero a una página concreta de una branch, copie la URL de la barra de direcciones de su navegador. Cualquier persona con acceso a su organización de Mintlify puede abrirla en su propia sesión del editor.
+
+```text
+https://app.mintlify.com/{org}/{project}/editor/{branch}/~/{filepath}
+```
+
+Por ejemplo: `https://app.mintlify.com/acme/docs/editor/main/~/guides/quickstart.mdx`
+
+
+
+## Revisar y hacer merge de pull requests
+
+
+
+Cuando hay una pull request abierta para la branch actual, el menú de publicación muestra un panel de revisión con:
+
+- El título y la descripción de la pull request
+- Las branches de origen y de destino
+- El número de archivos modificados
+- El requisito de aprobación de la deployment branch
+- El estado de revisión actual
+
+Después de que un revisor apruebe, haga clic en **Merge and publish** para hacer merge y desplegar desde el editor. El editor le devuelve a su deployment branch tras el merge.
+
+
+
+### Aprobar desde el editor
+
+
+
+En repositorios de GitHub, los revisores pueden aprobar pull requests abiertas sin salir del editor. Aparece un botón **Approve pull request** en el panel de revisión si su cuenta tiene permiso para revisarla. El estado cambia a **Approved** y **Merge and publish** queda disponible.
+
+Si usa GitLab o Bitbucket, abra la pull request en su proveedor de Git para aprobarla.
+
+
+
+### Comparar cambios antes de hacer merge
+
+
+
+Haga clic en cualquier archivo modificado del menú de publicación para abrirlo en la vista de diff frente a la versión publicada. El modo visual muestra un diff visual y el modo source muestra un diff de texto. Los archivos que no pueden mostrar un diff, como las imágenes o los archivos eliminados, aparecen en la lista pero no se pueden abrir.
+
+Las [páginas ocultas](/es/organize/hidden-pages) que aparecen en el diff de la branch se pueden abrir desde el menú de publicación, aunque no figuren en la navegación de su sitio.
+
+
+
+### Títulos y descripciones de pull requests
+
+
+
+Si su organización exige pull requests, puede escribir un título y una descripción al publicar. Si deja alguno en blanco, el editor genera uno con la lista de archivos que creó, actualizó, movió o eliminó. Para controlar cómo se redactan, configure las [instrucciones de PR](/es/editor/settings#pr-instructions).
+
+Si su branch tiene hilos de comentarios abiertos, Mintlify añade un resumen de estos a la descripción de la pull request. Consulte [Colaborar](/es/editor/collaborate#comments).
+
+
+
+## Revisar una ejecución de automatización
+
+
+
+Cuando una [automatización](/es/automations) abre una pull request, puede abrir el editor en la branch de la automatización:
+
+- Desde la página **Automation Runs** de su dashboard, haga clic en **Open in editor** en una ejecución completada.
+- Desde una notificación de Slack, haga clic en el enlace **View changes**.
+
+Cualquiera de las dos vías abre el editor en la branch de la automatización con las páginas modificadas preseleccionadas en el menú de publicación, de modo que puede revisar el diff y hacer merge o solicitar cambios sin salir del editor. El [agente](/es/editor/agent#continue-an-automation-run) se abre junto a él con contexto sobre lo que hizo la automatización.
diff --git a/es/editor/settings.mdx b/es/editor/settings.mdx
index aa386d9c2..58a15306a 100644
--- a/es/editor/settings.mdx
+++ b/es/editor/settings.mdx
@@ -1,116 +1,43 @@
---
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."
-keywords: ["editor", "settings", "ai", "instructions", "publishing", "pull request", "merge", "lock branch"]
+sidebarTitle: "Configuración"
+description: "Configure la apariencia del editor, las instrucciones de IA y los valores predeterminados de publicación para controlar cómo se ve el editor y cómo confirma y hace merge de los cambios."
+keywords: ["editor", "settings", "ai", "instructions", "publishing", "pull request", "merge", "appearance", "preferences"]
---
-El editor web tiene dos capas de configuración:
+La [página de configuración](https://app.mintlify.com/settings/deployment/editor) del editor controla la apariencia, el comportamiento de publicación y el comportamiento del agente.
-- **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.
+- **Appearance**: Preferencias personales sobre cómo se ve y se comporta el editor. Se aplican solo a usted.
+- **Publishing**: Valores predeterminados de todo el deployment sobre cómo el editor confirma cambios y abre pull requests. Se aplican a todas las personas que publican.
+- **Chat**: Instrucciones persistentes para el agente de IA del editor.
+- **Danger zone**: Acciones que no se pueden deshacer.
-Puede configurar ambas desde el panel de configuración. Para abrirlo, haga clic en el icono
-` para los avisos.
-
-Mantenga las instrucciones cortas y específicas. La IA las sigue en cada solicitud, así que las reglas vagas o contradictorias degradan los resultados.
-
- or components.
-- Do not add introductory filler like "In this guide" or "Let's explore".
-```
-
-Deje el campo vacío para eliminar sus instrucciones.
-
-
- Activar el bloqueo descarta cualquier edición del editor sin publicar en la rama de despliegue y fuerza la sincronización del editor con tu repositorio de Git. Publica las ediciones pendientes o muévelas a una rama borrador antes de activar el bloqueo.
-
-
-Mientras el bloqueo esté activo, los push entrantes de Git a la rama de despliegue sobrescriben el estado en vivo del editor, por lo que cualquier edición en curso en esa rama se reemplaza con el último commit.
+Las preferencias de apariencia están vinculadas a su cuenta de usuario y se aplican en cuanto las activa.
-Usa este ajuste cuando tu equipo quiera que Git siga siendo la fuente de verdad del sitio en producción, y que todos los cambios del editor pasen por pull requests desde ramas de funcionalidad.
+- **Fit editor to full width**: Extiende el lienzo de edición de borde a borde en lugar de usar la columna de ancho fijo predeterminada.
+- **Show breadcrumbs**: Muestra la ubicación de la página en la navegación del sitio encima del lienzo de edición.
+- **Open live preview in new tab**: Abre la página representada en una pestaña nueva del navegador al previsualizar. Déjelo desactivado para editar la configuración del sitio desde dentro de la [vista previa en vivo](/es/editor/review#live-preview).
+- **Show all files**: Muestra todos los archivos de la barra lateral, incluidos los dotfiles, el código, los PDF y otros archivos que el árbol de navegación oculta de forma predeterminada.
-Para editar mientras la rama de despliegue está bloqueada, usa el selector de ramas en la barra superior para crear una rama borrador o cambiarte a una. Publica esos cambios abriendo un pull request desde tu rama borrador, igual que con cualquier otra rama del editor.
+
-
-## Instrucciones de IA
-
-
-
-Las instrucciones de IA son pautas persistentes que el editor envía a la IA junto con su solicitud. Úselas para capturar reglas de estilo y tono que no quiere repetir cada vez, como voz, terminología o convenciones de formato.
-
-Sus instrucciones se aplican a:
-
-- Acciones **Edit with AI** sobre una selección, como reescribir, ampliar o corregir.
-- **Sesiones del agente** iniciadas desde el editor.
-
-Cada compañero de equipo mantiene sus propias instrucciones, asociadas a su cuenta de usuario.
-
-
-
-### Cuándo usar las instrucciones de IA
-
-
-
-Añada instrucciones de IA cuando se descubra repitiendo las mismas pautas en los prompts, por ejemplo:
-
-- Imponer el uso de la segunda persona o encabezados en mayúscula inicial.
-- Preferir nombres de producto o terminología específicos.
-- Prohibir lenguaje de marketing o frases de relleno.
-- Exigir ciertos componentes, como usar siempre `
-
-### Configurar las instrucciones de IA
-
-
-
-1. Haga clic en el icono
-
-## Configuración de publicación
-
-
-
-La configuración de publicación se establece por deployment y se aplica a todas las personas que publican desde el editor. Controla cómo el editor genera, abre y fusiona pull requests y commits.
-
-Necesita acceso de administrador a su deployment de Mintlify para cambiar la configuración de publicación.
-
-
-
-### Bloquear la rama de despliegue
+## Appearance
-Actívalo para que tu rama de despliegue (normalmente `main`) sea de solo lectura en el editor. Cuando la rama está bloqueada:
-
-- El editor y la vista de código fuente pasan a solo lectura para cualquier persona que esté viendo la rama de despliegue.
-- El panel de configuración de `docs.json` deja de guardar cambios.
-- Las ediciones de navegación —agregar páginas, reordenar y arrastrar y soltar— se ocultan.
-- Un aviso pide a los colaboradores que creen una rama borrador antes de hacer ediciones.
-
-Tu rama de despliegue permanece sincronizada con Git, por lo que los push desde tu repositorio siguen actualizando tu sitio en producción. El bloqueo solo afecta a las ediciones realizadas desde el editor.
-
-
-
+ Con los autocommits en la branch main activados, no hay estado pendiente ni posibilidad de revisar. Cada edición llega a su sitio publicado poco después de que deje de escribir.
+
-
-
-### Instrucciones para el pull request
+## Instrucciones de PR
-Las instrucciones para el pull request guían a la IA cuando genera el título y la descripción de un pull request. Se aplican siempre que el editor abre un pull request en su nombre, incluyendo los flujos **Create pull request** y **Merge and publish**.
+Las instrucciones de PR guían a la IA cuando genera el título y la descripción de una pull request. Se aplican siempre que el editor abre una pull request en su nombre, incluidos los flujos **Create pull request** y **Merge and publish**.
-Use las instrucciones para el pull request para estandarizar lo que ven los revisores, por ejemplo:
+Use las instrucciones de PR para estandarizar lo que ven los revisores, por ejemplo:
- Secciones obligatorias como **Summary** y **Changes**.
- Una plantilla de descripción que enlace con un sistema de seguimiento.
-- Requisitos de tono o de longitud para los títulos.
+- Requisitos de tono o longitud para los títulos.
Ejemplo:
@@ -121,86 +48,92 @@ Description: include a "## Summary" section (one sentence) and a
using its relative path.
```
+Las instrucciones tienen un límite de 20.000 caracteres.
+
-### Autocommits en la rama principal
+## Autocommits en la branch main
-Active esta opción para que el editor confirme automáticamente los cambios realizados en la deployment branch (normalmente `main`) poco después de que deje de editar. Cuando está desactivada, los cambios en la deployment branch quedan pendientes en el editor hasta que los publique.
-
-Use esta opción cuando su equipo edita directamente la deployment branch y quiere que las actualizaciones lleguen a Git sin un paso de publicación manual. Déjela desactivada si prefiere revisar los cambios en el editor antes de que lleguen a la deployment branch.
+Los autocommits en la branch main envían los cambios a su branch main automáticamente, poco después de que deje de escribir. Si activa este ajuste, el editor **oculta por completo las branches y el paso de publicación**. Los cambios se publican sin revisión.
-Esta opción solo afecta a la deployment branch. Las ediciones en branches de funcionalidades creadas desde el editor siguen confirmándose automáticamente sin importar este ajuste, y bloquear la deployment branch tiene prioridad.
+
+
-### Crear pull requests como borradores por defecto
+## Crear pull requests como borrador de forma predeterminada
-Active esta opción para que el editor abra todos los pull requests nuevos en estado de borrador. No puede fusionar un pull request en borrador hasta que lo marque como listo para revisión. Esto es útil cuando:
+Cuando este ajuste está activado, las pull requests nuevas creadas desde el editor se abren como borradores. No puede hacer merge de una pull request en borrador hasta que la marque como lista para revisión. Está activado de forma predeterminada.
-- Su equipo requiere una revisión manual antes de abrir el pull request para aprobación.
-- Quiere compartir URLs de vista previa sin indicar que el cambio está listo para fusionarse.
+Las pull requests en borrador son útiles cuando su equipo requiere una revisión manual antes de abrir una pull request para su aprobación, o cuando quiere compartir URLs de vista previa sin dar a entender que el cambio está listo para hacer merge.
-Todavía puede marcar un pull request como listo para revisión desde su proveedor de Git.
+
-
- Ajuste su método de fusión predeterminado a las reglas de protección de branches de su proveedor de Git. Si su deployment branch solo permite fusiones tipo squash, configure el valor predeterminado en **Squash** para evitar fusiones fallidas desde el editor.
+ Haga coincidir su método de merge con las reglas de protección de branch de su proveedor de Git. Si su deployment branch solo admite squash merges, elija **Squash** para evitar merges fallidos desde el editor.
-Branche de déploiement | Aucune | **Publish** directement sur votre site en production |
-| Branche de déploiement | Pull requests requises | **Create branch** pour déplacer les modifications vers une nouvelle branche |
-| Branche de fonctionnalité | Aucune | **Save in branch**, **Create pull request** |
-| Branche de fonctionnalité | Pull requests requises | **Save in branch**, **Create pull request** |
-
-- **Publish** : Valide et déploie immédiatement vos modifications sur votre site en production.
-- **Save in branch** : Valide vos modifications sur la branche de fonctionnalité sans les fusionner dans votre branche de déploiement.
-- **Create branch** : Déplace vos modifications en attente vers une nouvelle branche de fonctionnalité lorsque vous êtes sur une branche de déploiement protégée.
-- **Create pull request** : Ouvre une pull request ciblant votre branche de déploiement.
-
-S'il n'y a aucune modification en attente, l'éditeur désactive les actions de publication et d'enregistrement.
-
-
- Votre site en production se met à jour après que Mintlify a généré et déployé vos modifications. Cela prend généralement de 30 secondes à quelques minutes. Vérifiez le statut du déploiement sur votre [tableau de bord](https://app.mintlify.com).
-
-
-
- Utilisez des noms de branche descriptifs pour les identifier facilement et permettre aux autres de comprendre à quoi sert chaque branche.
-
-
-
- Changer de branche alors que vous avez des modifications non publiées vous invite à transférer ces modifications vers la nouvelle branche ou à les laisser sur place. Les modifications laissées de côté restent sur votre branche d'origine.
-
-
-
- Pour copier le nom d'une branche, survolez la branche dans la liste déroulante et cliquez sur l'icône de copie. Pratique pour partager la branche avec des coéquipiers ou la référencer dans une pull request.
-
-
-
-
-
-
-Copiez l'URL et envoyez-la aux relecteurs. L'aperçu se met à jour automatiquement chaque fois que vous enregistrez sur la branche.
-
-
- Configurez les règles de protection de branche dans votre fournisseur Git pour exiger des pull requests. Voir [About protected branches](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches) dans l'aide GitHub ou [Protected branches](https://docs.gitlab.com/user/project/repository/branches/protected/) dans l'aide GitLab.
-
-
-
+ Les [viewers](/fr/dashboard/roles) sont toujours en mode suggestion. Le mode suggestion s'active automatiquement quand un viewer ouvre l'éditeur, afin qu'il puisse proposer des modifications sans modifier directement le contenu.
+
+
+Cliquez sur une suggestion surlignée pour l'accepter ou la refuser. Dans les deux cas, le fil de la suggestion est résolu et supprimé. Une modification acceptée fait partie de votre branch actuelle et est mise en ligne la prochaine fois que vous [publiez](/fr/editor/publish).
+
+
-
- Une capture enregistrée de vos modifications à un moment précis. Chaque commit inclut un message décrivant ce qui a changé et crée un enregistrement permanent dans l'historique de votre projet.
-
- Lorsque vous publiez des modifications, l'éditeur web crée un commit dans votre référentiel Git.
-
-
- Une ligne de travail distincte dans votre référentiel. Parfois appelée **feature branch**.
-
- Votre site en production est généré à partir d'une **branche de déploiement**, généralement appelée `main`. Les autres branches vous permettent de travailler sur des modifications de manière indépendante, sans affecter votre site en production. Rien sur une branche n'est mis en ligne avant que vous ne la fusionniez dans votre branche de déploiement via une pull request.
-
- Basculez entre les branches à l'aide de la liste déroulante des branches dans la barre d'outils de l'éditeur. Si vous avez des modifications non publiées, l'éditeur vous permet de les transférer vers la nouvelle branche ou de les laisser sur votre branche actuelle.
-
-
- La branche qui génère votre site en production, généralement appelée `main`. Les modifications fusionnées dans cette branche sont automatiquement déployées sur votre site.
-
-
- Une proposition de fusionner des modifications d'une branche dans une autre. Les pull requests permettent à votre équipe d'examiner et de discuter les changements avant leur mise en production.
-
- Lorsque vous publiez des modifications sur une feature branch (ou lorsque votre référentiel exige des pull requests), l'éditeur web crée une pull request. Votre équipe examine et fusionne la pull request dans votre fournisseur Git (GitHub, GitLab ou Bitbucket).
-
-
- Combinaison des modifications d'une branche dans une autre. Après qu'une pull request a été examinée et approuvée par votre équipe, la fusion de la branche intègre vos modifications dans la branche de déploiement et les publie.
-
-
- Se produit lorsque deux branches comportent des modifications incompatibles sur les mêmes fichiers. L'éditeur vous aide à résoudre les conflits lorsqu'ils surviennent.
-
-
- Une comparaison montrant les différences entre deux versions d'un fichier. L'éditeur affiche un diff visuel de vos modifications en attente avant la publication, afin que vous puissiez vérifier exactement ce qui sera validé.
-
-
-
-` |
-| Changer de branche | `git checkout ` |
-| Push externe ou mise à jour via la CLI | Les modifications entrantes sont synchronisées automatiquement dans l'éditeur via un three-way merge. |
diff --git a/fr/editor/index.mdx b/fr/editor/index.mdx
index ceee4d9b2..e45150e9b 100644
--- a/fr/editor/index.mdx
+++ b/fr/editor/index.mdx
@@ -1,19 +1,17 @@
---
-title: "Aperçu de l'éditeur"
-sidebarTitle: "Vue d'ensemble"
-description: "Créez, modifiez et publiez du contenu dans votre navigateur avec collaboration en temps réel, sauvegarde automatique, aperçus en direct et sync Git."
-keywords: ["editor", "visual", "collaborative", "web editor"]
+title: "Présentation de l'éditeur"
+sidebarTitle: "Présentation"
+description: "Créez, modifiez et publiez du contenu dans votre navigateur avec l'éditeur Mintlify. Prend en charge la collaboration en temps réel et la synchronisation continue avec Git."
+keywords: ["web editor", "git", "branches", "commits", "pull requests"]
---
- Un guide pas à pas : créer une branche, faire une modification, partager un aperçu et publier.
+ Créez une branch, faites une modification, partagez un aperçu et publiez.
-
- Si l'éditeur semble désynchronisé avec votre référentiel, utilisez [Reset editor](/fr/editor/settings#reset-editor) pour forcer une resynchronisation depuis Git. Par exemple, l'arborescence des fichiers est vide ou affiche `Unable to find docs.json` alors que le fichier est présent sur votre branche de déploiement.
-
+**Git reste synchronisé.** Lorsque quelqu'un pousse des modifications vers votre dépôt, elles apparaissent automatiquement. Vous n'avez pas besoin de faire un pull ni d'actualiser. L'éditeur fusionne les modifications sans conflit et signale tout ce qui requiert votre attention.
-**La publication écrit dans Git.** Lorsque vous publiez, l'éditeur valide vos modifications dans votre référentiel. Sur une branche de déploiement, cela met immédiatement à jour votre site en production. Sur une branche de fonctionnalité, cela crée une pull request.
+**Votre équipe travaille ensemble.** Plusieurs personnes peuvent modifier la même page en même temps, avec des curseurs en direct qui montrent qui travaille où. Les commentaires et les suggestions sont visibles par tous.
-**Votre équipe édite ensemble.** Plusieurs personnes peuvent modifier la même page simultanément. Les curseurs en direct indiquent qui édite et à quel endroit.
+
+ Si l'éditeur semble désynchronisé par rapport à votre dépôt, utilisez [Réinitialiser l'éditeur](/fr/editor/settings#reset-editor) pour forcer une resynchronisation. Par exemple, une arborescence de fichiers vide ou l'erreur `Unable to find docs.json` apparaît alors que le fichier est bien présent sur votre deployment branch.
+
-
-
-### Método de fusión predeterminado
+## Método de merge de PR
-Elija cómo fusiona el editor los pull requests cuando hace clic en **Merge and publish**:
+Elija cómo hace merge el editor de las pull requests cuando hace clic en **Merge and publish**:
-- **Merge**: Crea un commit de fusión que preserva el historial completo de la branch.
+- **Merge**: Crea un commit de merge que conserva el historial completo de la branch. Es la opción predeterminada.
- **Squash**: Combina todos los commits de la branch en un único commit en su deployment branch.
-- **Rebase**: Reproduce cada commit de la branch sobre su deployment branch sin crear un commit de fusión.
+- **Rebase**: Reaplica cada commit de la branch sobre su deployment branch sin un commit de merge.
-El editor usa el método seleccionado por defecto. Si pasa un método de fusión explícito a través de la API o de la interfaz de su proveedor de Git, esa elección tiene prioridad.
+Si indica un método de merge explícito a través de la API o de la interfaz de su proveedor de Git, esa elección tiene prioridad.
+
- Restablecer el editor descarta cualquier cambio no publicado que no se haya confirmado en Git. Si tiene ediciones pendientes que quiere conservar, publíquelas primero.
-
+- Exigir la segunda persona o títulos en formato de frase.
+- Preferir nombres de producto o terminología concretos.
+- Prohibir el lenguaje de marketing o las frases de relleno.
+- Exigir determinados componentes, como usar siempre `` para las llamadas de atención.
-Para restablecer el editor:
+Mantenga las instrucciones breves y concretas. La IA las sigue en cada solicitud, así que las reglas vagas o contradictorias empeoran los resultados.
-1. Haga clic en el icono or components.
+- Do not add introductory filler like "In this guide" or "Let's explore".
+```
-
- La acción **Reset editor** se encuentra en el panel de configuración del editor, no en la [Danger zone](https://app.mintlify.com/settings/organization/danger-zone) de la configuración de su dashboard. La Danger zone del dashboard solo se usa para [eliminar un deployment](/es/deploy/deployments#delete-a-deployment).
-
+Deje el campo vacío para eliminar sus instrucciones.
-
- [Installer la CLI](/fr/cli/install) : Installez la CLI et préparez-la à l'utilisation.
+- [Extension Mintlify MDX](/fr/cli/mdx-extension) : Ajoutez l'autocomplétion, la vérification des erreurs en ligne et une prévisualisation dans l'éditeur.
- [Prévisualisation locale](/fr/cli/preview) : Lancez un serveur de développement local avec la recherche et l'assistant.
- [Commandes](/fr/cli/commands) : Référence complète de toutes les commandes et options.
diff --git a/fr/cli/install.mdx b/fr/cli/install.mdx
index f23bd28ac..56d298e9c 100644
--- a/fr/cli/install.mdx
+++ b/fr/cli/install.mdx
@@ -121,14 +121,16 @@ Si `mint update` n'est pas disponible dans votre version, réinstallez la CLI av
```
-
-## Danger zone
+## Instrucciones de IA
-La sección **Danger zone** del panel de configuración del editor contiene acciones que no se pueden deshacer. Ábrala desde el icono
+Sus instrucciones se aplican a:
-### Reset editor
+- Las acciones de **Edit with AI** sobre una selección, como reescribir, ampliar o corregir.
+- Las sesiones del agente iniciadas desde el editor.
-
+Cada compañero mantiene sus propias instrucciones, vinculadas a su cuenta de usuario. Las instrucciones tienen un límite de 20.000 caracteres.
-**Reset editor** obliga al editor a descartar su estado local y volver a sincronizarse desde su repositorio de Git. Úselo cuando el editor se quede desincronizado con su repositorio — por ejemplo, cuando el árbol de archivos está vacío o muestra errores como `Unable to find docs.json or mint.json` aunque el archivo exista en su deployment branch y su sitio en producción se compile con normalidad.
+Añada instrucciones de IA cuando se dé cuenta de que repite las mismas directrices en los prompts, por ejemplo:
-
+
+ Si restablece el editor, descarta cualquier cambio sin publicar que no haya confirmado en Git. Si tiene ediciones pendientes que quiere conservar, publíquelas primero.
+
diff --git a/es/editor/suggestions.mdx b/es/editor/suggestions.mdx
deleted file mode 100644
index dd532d06a..000000000
--- a/es/editor/suggestions.mdx
+++ /dev/null
@@ -1,57 +0,0 @@
----
-title: "Guía para sugerir cambios de texto en el editor de Mintlify"
-description: "Propón cambios de texto como sugerencias que tus compañeros pueden revisar, aceptar o rechazar en el editor sin modificar el contenido actual."
-keywords: ["sugerencias", "sugerir", "colaboración", "revisión"]
----
-
-Las sugerencias te permiten proponer cambios al texto sin alterar el contenido actual. Tus compañeros pueden revisar, aceptar o rechazar tus sugerencias.
-
-El modo de sugerencia se aplica al texto de la página. Los editors y admins pueden aceptar o rechazar cualquier sugerencia; los viewers no. Consulta [roles](/es/dashboard/roles) para más detalles.
-
-Las sugerencias pendientes aparecen como texto resaltado en el editor y se muestran en la barra lateral junto a los comentarios para que los revisores puedan encontrarlas.
-
-Cuando el modo de sugerencias está activo, el editor muestra un indicador **Suggesting** en la barra superior. El indicador confirma que tus ediciones se guardarán como sugerencias.
-
-
- Los [viewers](/es/dashboard/roles) siempre están en modo de sugerencias. El modo de sugerencias se activa automáticamente cuando un viewer abre el editor. El indicador **Suggesting** es visible, pero no interactivo para los viewers, por lo que permanecen en modo de sugerencias. Esto les permite proponer cambios sin editar directamente el contenido.
-
-
-
-
-
-
-
-` plus clairs pour les branches générées automatiquement. Consultez [Création de branches et publication](/fr/editor/branching-and-publishing).
+ - **Branches v2 et historique des versions :** Les branches de l'éditeur sont désormais associées à des pull requests en brouillon et enregistrent automatiquement les modifications dans Git. Vous pouvez renommer ou supprimer des branches, abandonner des modifications enregistrées automatiquement et déplacer les modifications en attente vers une nouvelle branche. Le menu des branches est trié par activité récente, utilise des noms propres à chaque utilisateur et affiche des noms `Draft ` plus clairs pour les branches générées automatiquement. Consultez [Création de branches et publication](/fr/editor/publish).
- **Navigation simplifiée dans l'éditeur :** L'éditeur propose une nouvelle ligne de fil d'Ariane, des contrôles de page et de partage regroupés, des en-têtes de section fixes dans la barre latérale et une barre inférieure dédiée aux paramètres et à **Ask agent**. Sur les petits écrans, la navigation mobile utilise désormais une barre supérieure simplifiée et une barre latérale sous forme de panneau.
- **Accès aux pages et commentaires :** Demandez l'accès en modification à une page privée ou protégée depuis l'éditeur et examinez les demandes dans une fenêtre d'approbation. Les cartes de commentaires affichent désormais les photos de profil et les @mentions renvoient vers la personne mentionnée.
- **Améliorations de la live preview :** Exécutez plusieurs prévisualisations locales à la fois. Les modifications de navigation se propagent aux prévisualisations ouvertes, le panneau de l'agent s'ancre à gauche et la prévisualisation reste visible pendant les tours de suivi de l'onboarding.
@@ -179,7 +179,7 @@ noindex: true
- **Flux de revue :** Demandez une revue sur un brouillon, laissez des retours et approuvez ou demandez des modifications avant publication. Les revues prennent désormais en charge les branches sans déploiement.
- - **Davantage de façons de collaborer :** Démarrez des [fils de commentaires](/fr/editor/comments) sur une page entière, mentionnez-vous pour laisser un rappel et utilisez les raccourcis clavier Option + C ou Option + S pour commenter ou suggérer des modifications sur le texte sélectionné.
+ - **Davantage de façons de collaborer :** Démarrez des [fils de commentaires](/fr/editor/collaborate#comments) sur une page entière, mentionnez-vous pour laisser un rappel et utilisez les raccourcis clavier Option + C ou Option + S pour commenter ou suggérer des modifications sur le texte sélectionné.
- **Édition plus rapide et disponible :** L'éditeur s'affiche sans attendre l'arborescence Git et les personnes sans accès en écriture GitHub peuvent l'utiliser.
-## Relacionado
+## Restablecer editor
-- [Branches y publicación](/es/editor/branching-and-publishing)
-- [Configuraciones](/es/editor/configurations)
+**Reset editor** obliga al editor a descartar su estado local y sincronizarse con su repositorio de Git. Restablezca el editor si se queda desincronizado con su repositorio, por ejemplo si el árbol de archivos está vacío o muestra errores como `Unable to find docs.json`. Esto puede ocurrir aunque el archivo exista en su deployment branch y su sitio se compile con normalidad.
+
+
- ## Hacer sugerencias
-
-
-1. Resalta cualquier texto de la página.
-2. Haz clic en el botón
-
-
-
-
- ## Aceptar una sugerencia
-
-
-1. Haz clic en el texto de la sugerencia resaltada.
-2. Haz clic en el botón
- ## Rechazar una sugerencia
-
-
-1. Haz clic en el texto de la sugerencia resaltada.
-2. Haz clic en el botón
## Un build convierte los archivos fuente en experiencias para el lector
diff --git a/es/reference/glossary.mdx b/es/reference/glossary.mdx
index 1e3e1cb80..e1b8e76fb 100644
--- a/es/reference/glossary.mdx
+++ b/es/reference/glossary.mdx
@@ -196,7 +196,7 @@ Una versión específica por localización de tu documentación configurada en l
### Vista previa en vivo
-La renderización que se actualiza continuamente con tus ediciones no publicadas dentro del editor web. Una vista previa en vivo no se despliega públicamente. Consulta [Vista previa en vivo](/es/editor/live-preview).
+La renderización que se actualiza continuamente con tus ediciones no publicadas dentro del editor web. Una vista previa en vivo no se despliega públicamente. Consulta [Vista previa en vivo](/es/editor/review#live-preview).
### Sitio en producción
diff --git a/fr.json b/fr.json
index ad77c4d16..0e057102e 100644
--- a/fr.json
+++ b/fr.json
@@ -15,6 +15,7 @@
"root": "fr/cli/index",
"pages": [
"fr/cli/install",
+ "fr/cli/mdx-extension",
"fr/cli/preview",
"fr/cli/commands"
]
@@ -99,15 +100,11 @@
"root": "fr/editor/index",
"pages": [
"fr/editor/tutorial",
- "fr/editor/git-essentials",
"fr/editor/pages",
- "fr/editor/navigation",
- "fr/editor/live-preview",
- "fr/editor/branching-and-publishing",
- "fr/editor/comments",
- "fr/editor/suggestions",
+ "fr/editor/publish",
+ "fr/editor/review",
+ "fr/editor/collaborate",
"fr/editor/agent",
- "fr/editor/configurations",
"fr/editor/settings",
"fr/editor/keyboard-shortcuts"
]
diff --git a/fr/changelog.mdx b/fr/changelog.mdx
index 4d075ee68..438be6587 100644
--- a/fr/changelog.mdx
+++ b/fr/changelog.mdx
@@ -11,7 +11,7 @@ noindex: true
## Éditeur et collaboration
- - **Branches v2 et historique des versions :** Les branches de l'éditeur sont désormais associées à des pull requests en brouillon et enregistrent automatiquement les modifications dans Git. Vous pouvez renommer ou supprimer des branches, abandonner des modifications enregistrées automatiquement et déplacer les modifications en attente vers une nouvelle branche. Le menu des branches est trié par activité récente, utilise des noms propres à chaque utilisateur et affiche des noms `Draft
@@ -236,7 +236,7 @@ noindex: true
## Améliorations de l'éditeur
- - **Brouillons :** Travaillez sur des modifications non publiées sans créer de branche ni utiliser de commandes Git. Consultez [Brouillons](/fr/editor/branching-and-publishing) pour plus d'informations.
+ - **Brouillons :** Travaillez sur des modifications non publiées sans créer de branche ni utiliser de commandes Git. Consultez [Brouillons](/fr/editor/publish) pour plus d'informations.
- **Verrouiller la branche de déploiement :** L'éditeur propose désormais de verrouiller votre branche de déploiement s'il détecte des protections de branche.
- **[Agent de l'éditeur](/fr/editor) plus rapide avec un meilleur annuler/rétablir :** Les mises à jour de l'agent s'affichent désormais instantanément, la navigation est plus rapide, et les modifications de contenu et d'arborescence de navigation peuvent être annulées et rétablies proprement.
- **État des titres repliables conservé par utilisateur :** Vos préférences de sections dépliées et repliées sont conservées d'une session à l'autre de l'éditeur.
@@ -1071,7 +1071,7 @@ noindex: true
- Refonte de la page de paramètres de configuration de l'éditeur avec une mise en page améliorée et le support de la sauvegarde automatique.
- Les pages générées automatiquement à partir des spécifications OpenAPI apparaissent désormais dans l'éditeur web comme des entrées en lecture seule.
- - Support vidéo dans l'[aperçu en direct](/fr/editor/live-preview). Les fichiers mp4, webm et mov intégrés s'affichent désormais correctement pendant le développement local.
+ - Support vidéo dans l'[aperçu en direct](/fr/editor/review#live-preview). Les fichiers mp4, webm et mov intégrés s'affichent désormais correctement pendant le développement local.
- Les [automatisations](/fr/automations) peuvent désormais être désactivées et réactivées depuis le tableau de bord.
- Les analyses de l'assistant affichent désormais l'utilisation ventilée par source (web vs API) dans le tableau de bord.
- La recherche MCP authentifiée filtre désormais correctement les résultats en fonction des groupes d'authentification de l'utilisateur.
@@ -1620,7 +1620,7 @@ Consultez les retours ventilés par pages individuelles dans votre tableau de bo
## Améliorations de l’éditeur web
- * Ajout de [liens de prévisualisation partageables](/fr/editor/branching-and-publishing#access-and-share-a-preview) depuis la barre d’outils de l’éditeur.
+ * Ajout de [liens de prévisualisation partageables](/fr/editor/review#preview-deployments) depuis la barre d’outils de l’éditeur.
* Mise à jour du [flux de publication](/fr/editor/publish) pour prendre en charge la publication en un clic ou la création de pull requests (demandes de fusion).
* Le travail dans l’éditeur web ne nécessite plus de se connecter avec GitHub.
diff --git a/fr/cli/index.mdx b/fr/cli/index.mdx
index a9103cd73..6c4c4469a 100644
--- a/fr/cli/index.mdx
+++ b/fr/cli/index.mdx
@@ -86,5 +86,6 @@ https://mcp.mintlify.com
- ## Formatage
+
-Cliquez sur l'icône d'horloge dans l'en-tête du panneau pour voir vos précédentes sessions de chat. Cliquez sur une session pour la rouvrir et voir ce que l'agent a modifié.
+Cliquez sur l'icône d'horloge dans l'en-tête du panneau pour voir vos sessions de chat précédentes. Cliquez sur une session pour la rouvrir et voir ce que l'agent a modifié.
+ ## Prise en charge des éditeurs
-Pour la coloration syntaxique et le formatage du code dans les fichiers MDX, nous recommandons les extensions suivantes :
+Pour la coloration syntaxique, l'autocomplétion et la vérification des erreurs dans les fichiers MDX, utilisez les extensions suivantes :
-- **Cursor, Devin Desktop, VS Code** : [Extension MDX pour VS Code](https://marketplace.visualstudio.com/items?itemName=unifiedjs.vscode-mdx) et [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode)
-- **JetBrains** : [Plugin MDX pour IntelliJ IDEA](https://plugins.jetbrains.com/plugin/14944-mdx) et [Prettier](https://prettier.io/docs/webstorm)
+- **Cursor, Devin Desktop, VS Code** : [Extension Mintlify MDX](/fr/cli/mdx-extension) et [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) pour le formatage.
+- **JetBrains** : [Plugin MDX pour IntelliJ IDEA](https://plugins.jetbrains.com/plugin/14944-mdx) et [Prettier](https://prettier.io/docs/webstorm).
+
+Vous pouvez également formater les fichiers MDX avec [`mint format`](/fr/cli/commands#mint-format).
## Dépannage
diff --git a/fr/cli/mdx-extension.mdx b/fr/cli/mdx-extension.mdx
new file mode 100644
index 000000000..d82167b10
--- /dev/null
+++ b/fr/cli/mdx-extension.mdx
@@ -0,0 +1,169 @@
+---
+title: "Extension Mintlify MDX"
+description: "Installez l'extension Mintlify MDX pour bénéficier de l'autocomplétion, des diagnostics en ligne, de la documentation au survol et d'une prévisualisation dans l'éditeur pendant que vous rédigez du MDX en local."
+keywords: ["Cursor", "MDX", "autocomplétion", "diagnostics", "IntelliSense", "prévisualisation", "éditeur"]
+---
+
+L'extension Mintlify MDX ajoute la prise en charge du langage pour les projets Mintlify à VS Code, Cursor, Devin Desktop et aux autres éditeurs compatibles avec l'API d'extensions de VS Code. L'extension connaît chaque composant intégré et chaque propriété, vous bénéficiez donc de l'autocomplétion pendant la saisie, et elle signale les composants inconnus, les propriétés invalides et les imports de snippets non résolus.
+
+L'extension exécute également une prévisualisation en direct dans votre éditeur, ce qui vous permet de rédiger et de voir le rendu sans passer par un navigateur.
+
+
+ Utilisez la prévisualisation dans l'éditeur pendant que vous rédigez des pages individuelles, et [`mint dev`](/fr/cli/preview) dans un navigateur lorsque vous voulez tester la navigation, la recherche ou l'authentification sur l'ensemble de votre site.
+
+
+
+
+ L'extension résout les composants par rapport à la racine de votre documentation. Exécutez **Mintlify: Show detected docs root** pour confirmer qu'elle a trouvé le bon fichier `docs.json`. Si la racine est incorrecte ou manquante, ouvrez le dossier contenant votre fichier `docs.json` comme espace de travail.
+
+ Si la racine est correcte, exécutez **Mintlify: Restart language server**.
+
+
+ Une autre extension MDX est probablement active elle aussi. Ouvrez la vue Extensions, recherchez `mdx` et désactivez toute autre extension MDX dans cet espace de travail.
+
+
+ Ouvrez le canal de sortie **Mintlify Preview** pour voir l'erreur de `mint dev`.
+
+ - `could not run "mint dev --no-open"` : la CLI n'est pas installée. Installez-la avec `npm i -g mint`.
+ - `Trust the workspace first` : faites confiance à l'espace de travail via **Manage Workspace Trust**.
+ - `no docs.json found above this file` : ouvrez le dossier contenant votre fichier `docs.json` comme espace de travail.
+ - `Invalid docs.json` : exécutez [`mint validate`](/fr/cli/commands#mint-validate) pour trouver l'erreur de configuration.
+
+
+ Les chemins d'import absolus se résolvent depuis la racine de votre documentation, pas depuis votre fichier. Vérifiez que le chemin correspond à l'emplacement du fichier de snippet par rapport à votre fichier `docs.json`, et que la racine détectée est correcte.
+
+
diff --git a/fr/cli/preview.mdx b/fr/cli/preview.mdx
index ec63f517f..827cdd65d 100644
--- a/fr/cli/preview.mdx
+++ b/fr/cli/preview.mdx
@@ -35,6 +35,10 @@ Pour générer une prévisualisation sans installer la CLI globalement, exécute
npx mint dev
```
+
+ Si vous rédigez dans VS Code ou Cursor, l'[extension Mintlify MDX](/fr/cli/mdx-extension) exécute cette prévisualisation dans un panneau à côté de votre éditeur et la fait défiler pour correspondre à la page que vous modifiez.
+
+
-Lorsque vous ouvrez l'éditeur depuis une exécution d'automatisation terminée en cliquant sur **View changes**, le panneau de l'agent s'ouvre automatiquement avec le contexte de ce que l'automatisation a fait. Une carte **Pages modifiées** en haut du chat liste chaque page modifiée par l'automatisation — cliquez sur une page pour ouvrir une vue de diff.
+Lorsque vous ouvrez l'éditeur depuis une exécution d'automatisation terminée en cliquant sur **View changes**, le panneau de l'agent s'ouvre automatiquement avec le contexte de ce qu'a fait l'automatisation. Une carte **Changed pages** en haut du chat liste toutes les pages modifiées par l'automatisation. Cliquez sur une page pour ouvrir une vue diff.
-L'agent dispose du contexte du prompt de l'automatisation, d'un résumé des modifications qu'elle a effectuées et des pages qu'elle a modifiées. Vous pouvez lui demander d'affiner ou d'étendre le travail de l'automatisation sans avoir à réexpliquer le contexte.
+L'agent dispose du prompt de l'automatisation, d'un résumé des modifications effectuées et de la liste des pages concernées. Vous pouvez lui demander d'affiner ou de prolonger son travail sans avoir à réexpliquer le contexte.
Par exemple : `The new section on rate limits is too long. Trim it to three sentences.`
@@ -164,7 +154,7 @@ Par exemple : `The new section on rate limits is too long. Trim it to three sent
+ ## Prérequis
+
+
+- VS Code 1.85.0 ou plus récent
+- Un répertoire de documentation avec un fichier `docs.json` valide
+- La [CLI Mintlify](/fr/cli/install), uniquement pour la prévisualisation dans l'éditeur
+
+
+ ## Installer l'extension
+
+
+Installez depuis la ligne de commande :
+
+```bash
+code --install-extension mintlify.mintlify-snippets
+```
+
+Ou installez depuis votre éditeur :
+
+1. Ouvrez la vue Extensions.
+2. Recherchez `@id:mintlify.mintlify-snippets`.
+3. Cliquez sur **Install**.
+
+Vous pouvez également l'installer depuis le [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=mintlify.mintlify-snippets).
+
+L'extension s'active lorsque vous ouvrez un fichier `.mdx` ou un espace de travail contenant un fichier `docs.json`.
+
+
+ ## Autocomplétion
+
+
+Tapez `<` pour afficher tous les composants intégrés. L'autocomplétion suggère les propriétés et les valeurs des composants à l'intérieur des balises.
+
+L'extension suggère les composants que vous importez depuis des [snippets réutilisables](/fr/create/reusable-snippets) aux côtés des composants intégrés.
+
+
+ ## Diagnostics
+
+
+L'extension signale les problèmes dans le panneau Problèmes et les souligne dans votre fichier pendant que vous rédigez :
+
+- Composants inconnus.
+- Propriétés inconnues ou en double.
+- Valeurs invalides pour les propriétés énumérées.
+- Propriétés requises manquantes.
+- Balises non fermées ou mal appariées.
+- Imports de snippets non résolus.
+
+Ces classes d'erreurs provoquent des échecs de build, corrigez-les donc au fil de la rédaction pour éviter des déploiements en échec.
+
+Pour désactiver les diagnostics, définissez `mintlify.diagnostics.enabled` sur `false`.
+
+
+ ## Documentation au survol
+
+
+Survolez un composant ou une propriété pour voir sa fonction et un lien vers sa page dans la documentation Mintlify. Le survol d'un composant de snippet prévisualise le contenu du fichier de snippet.
+
+
+ ## Atteindre la définition
+
+
+Maintenez CMD (macOS) ou CTRL (Windows) et cliquez pour accéder à la définition :
+
+- des composants de snippet ;
+- des chemins d'import ;
+- des attributs `href` et `src` qui pointent vers des pages locales.
+
+L'extension trouve la racine de votre documentation en remontant depuis le fichier ouvert jusqu'à trouver `docs.json`, de sorte que les imports absolus comme `/snippets/example.mdx` se résolvent correctement. Le projet détecté apparaît dans la barre d'état. Pour vérifier quelle racine l'extension utilise, exécutez **Mintlify: Show detected docs root** depuis la palette de commandes.
+
+
+ ## Validation de la configuration
+
+
+L'extension valide `docs.json` par rapport au [schéma Mintlify](https://mintlify.com/docs.json).
+
+
+ ## Prévisualisation dans votre éditeur
+
+
+Ouvrez un fichier `.mdx` et sélectionnez l'icône de prévisualisation dans la barre de titre de l'éditeur, ou faites un clic droit sur le fichier et sélectionnez **Preview Mintlify**. Un panneau de prévisualisation s'ouvre à côté de votre éditeur et affiche le rendu de la page.
+
+Les prévisualisations dans l'éditeur nécessitent la [CLI Mintlify](/fr/cli/install). L'URL du serveur en cours d'exécution apparaît dans la barre d'état. Sélectionnez-la pour arrêter le serveur, ou exécutez **Mintlify: Stop preview server**.
+
+Pour voir la sortie du processus `mint dev` sous-jacent, ouvrez le canal de sortie **Mintlify Preview**.
+
+
+ ## Encadrer du contenu dans des composants
+
+
+L'extension inclut des snippets qui encadrent le texte sélectionné dans un composant, plutôt que d'insérer un composant vide à remplir.
+
+Pour les utiliser, sélectionnez le contenu à encadrer, puis exécutez **Snippets: Surround With** depuis la palette de commandes et choisissez un composant. Des snippets sont disponibles pour `AccordionGroup`, `CardGroup`, `CodeGroup`, `Expandable`, `Frame`, `RequestExample`, `ResponseExample` et les blocs de code délimités.
+
+
+ ## Paramètres
+
+
+| Paramètre | Valeur par défaut | Description |
+| --- | --- | --- |
+| `mintlify.diagnostics.enabled` | `true` | Signale les composants inconnus, les propriétés inconnues, les propriétés requises manquantes et les imports de snippets non résolus. |
+| `mintlify.warnAboutConflictingExtensions` | `true` | Avertit lorsqu'une autre extension MDX est installée aux côtés de l'extension Mintlify MDX. |
+| `mintlify.preview.command` | `mint dev --no-open` | Commande utilisée pour démarrer le serveur de prévisualisation, exécutée depuis la racine de votre projet. |
+| `mintlify.preview.followScroll` | `true` | Fait défiler la prévisualisation jusqu'au titre le plus proche du haut de votre éditeur. |
+
+`mintlify.preview.command` est un paramètre utilisateur, un espace de travail ne peut donc pas le remplacer. Cela empêche un dépôt cloné d'exécuter une commande arbitraire sur votre machine lorsque vous ouvrez une prévisualisation.
+
+
+ ## Commandes
+
+
+Exécutez-les depuis la palette de commandes :
+
+| Commande | Description |
+| --- | --- |
+| **Mintlify: Preview Mintlify** | Ouvre le panneau de prévisualisation pour le fichier actuel. |
+| **Mintlify: Stop preview server** | Arrête le serveur de prévisualisation en cours d'exécution. |
+| **Mintlify: Show detected docs root** | Affiche le fichier `docs.json` que l'extension a résolu. |
+| **Mintlify: Open component docs** | Ouvre la documentation du composant sous votre curseur. |
+| **Mintlify: Restart language server** | Redémarre le serveur de langage. |
+
+
+ ## Extensions en conflit
+
+
+D'autres extensions MDX fournissent leur propre coloration syntaxique et leurs propres fonctionnalités de langage pour les fichiers `.mdx`, ce qui entre en conflit avec cette extension. Désactivez les autres extensions MDX pour éviter les suggestions en double et une coloration incohérente.
+
+Pour le formatage du code, utilisez [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) aux côtés de cette extension ou exécutez [`mint format`](/fr/cli/commands#mint-format).
+
+
+ ## Dépannage
+
+
+
## Se connecter pour la recherche et l'assistant
diff --git a/fr/deploy/authentication-setup.mdx b/fr/deploy/authentication-setup.mdx
index e4d6aff5a..d5bb44f69 100644
--- a/fr/deploy/authentication-setup.mdx
+++ b/fr/deploy/authentication-setup.mdx
@@ -581,4 +581,4 @@ Certaines fonctionnalités se comportent différemment ou ne sont pas disponible
| [skill.md](/fr/ai/skillmd) | Prise en charge complète | Non pris en charge | Non pris en charge |
| [Sitemap](/fr/optimize/seo#sitemaps-and-robotstxt-files) | Prise en charge complète | Disponible derrière l’authentification, mais exclut les pages dans des groupes | Disponible derrière l’authentification, mais exclut les pages dans des groupes |
| [robots.txt](/fr/optimize/seo#sitemaps-and-robotstxt-files) | Prise en charge complète | Disponible derrière l’authentification | Disponible derrière l’authentification |
-| [Aperçu en direct](/fr/editor/live-preview) | Prise en charge complète | Pris en charge avec authentification automatique de l’éditeur | Pris en charge avec authentification automatique de l’éditeur |
+| [Aperçu en direct](/fr/editor/review#live-preview) | Prise en charge complète | Pris en charge avec authentification automatique de l’éditeur | Pris en charge avec authentification automatique de l’éditeur |
diff --git a/fr/editor/agent.mdx b/fr/editor/agent.mdx
index 75bcdb1e9..6a501867f 100644
--- a/fr/editor/agent.mdx
+++ b/fr/editor/agent.mdx
@@ -1,12 +1,12 @@
---
-title: "Demander à l'agent"
-description: "Utilisez l'agent IA de l'éditeur pour rédiger et modifier des pages, laisser commentaires et suggestions, rechercher et gérer les paramètres."
+title: "Interroger l'agent"
+description: "Utilisez l'agent d'IA intégré à l'éditeur pour rédiger du contenu, modifier des pages, laisser des commentaires et des suggestions, faire des recherches sur votre site, téléverser des fichiers et configurer des paramètres."
keywords: ["editor", "AI", "assistant", "agent", "chat", "comments", "suggestions", "code mode", "file upload"]
---
-L'éditeur inclut un agent intégré qui peut modifier des pages, réorganiser la navigation, mettre à jour `docs.json`, effectuer des recherches dans l'ensemble de votre référentiel et gérer les paramètres du tableau de bord.
+L'éditeur intègre un agent capable de modifier des pages, de réorganiser la navigation, de mettre à jour `docs.json`, de faire des recherches dans tout votre dépôt et de gérer les paramètres du dashboard.
-L'agent de l'éditeur effectue les modifications directement sur votre branche actuelle.
+L'agent de l'éditeur applique ses modifications directement sur votre branch actuelle.
@@ -16,17 +16,7 @@ L'agent de l'éditeur effectue les modifications directement sur votre branche a
Cliquez sur **Ask agent** dans la barre d'outils de l'éditeur, ou appuyez sur Cmd + I (macOS) ou Ctrl + I (Windows).
-Pour fermer le panneau, cliquez sur le bouton **X** dans l'en-tête du panneau ou appuyez à nouveau sur Cmd + I.
-
-
-Cliquez sur l'icône en forme de trombone dans la zone de chat, ou faites glisser-déposer des fichiers dans le panneau. L'agent lit les fichiers joints comme contexte pour votre requête.
+Cliquez sur l'icône du trombone dans la zone de chat, ou faites glisser des fichiers sur le panneau. L'agent lit les fichiers joints comme contexte pour votre demande.
Types de fichiers pris en charge :
- **Images** : JPG, PNG, GIF, WebP, SVG
- **Documents** : PDF
-- **Code et texte** : `.js`, `.ts`, `.jsx`, `.tsx`, `.mdx`, `.md`, `.json`, `.yaml`, `.html`, `.css`, Python, Go, Rust, Ruby, Java, Swift, C, C++, SQL, scripts shell, et plus encore
+- **Code et texte** : `.js`, `.ts`, `.jsx`, `.tsx`, `.mdx`, `.md`, `.json`, `.yaml`, `.html`, `.css`, Python, Go, Rust, Ruby, Java, Swift, C, C++, SQL, scripts shell et plus encore
Taille maximale : 5 Mo par fichier, sauf pour les fichiers SVG, limités à 256 Ko. Maximum : 10 fichiers par message.
-Mintlify supprime les scripts et autres contenus actifs des fichiers SVG avant que l'agent ne les lise.
+Mintlify retire les scripts et les autres contenus actifs des fichiers SVG avant que l'agent ne les lise.
-
-## Envoyer un message
-
-
-
-Saisissez votre requête dans la zone de chat en bas du panneau et appuyez sur Enter ou cliquez sur le bouton d'envoi
@@ -59,7 +49,7 @@ Mintlify supprime les scripts et autres contenus actifs des fichiers SVG avant q
-En mode visuel, sélectionnez du texte sur une page. Une barre d'outils flottante apparaît au-dessus de la sélection. Cliquez sur **Add to agent** pour envoyer le texte sélectionné à l'agent comme contexte.
+En mode visuel, sélectionnez du texte et cliquez sur **Add to agent** dans la barre d'outils flottante pour l'envoyer à l'agent comme contexte.
@@ -67,26 +57,26 @@ En mode visuel, sélectionnez du texte sur une page. Une barre d'outils flottant
-Par défaut, l'agent modifie directement le contenu. Pour obtenir du feedback sans modifier immédiatement la page, demandez explicitement à l'agent de relire la page, de laisser des commentaires ou de faire des suggestions.
+Par défaut, l'agent modifie le contenu directement. Pour obtenir un retour sans modifier la page tout de suite, demandez-lui explicitement de relire la page, de laisser des commentaires ou de faire des suggestions.
-- Les [suggestions](/fr/editor/suggestions) proposent un remplacement précis que vous pouvez accepter ou refuser. Le texte d'origine reste visible barré jusqu'à votre décision, et l'agent peut inclure une explication dans le fil de la suggestion.
-- Les [commentaires](/fr/editor/comments) laissent un retour ou une question ancrée à un texte précis sans modifier la page.
+- Les [suggestions](/fr/editor/collaborate#suggestions) proposent un remplacement précis que vous pouvez accepter ou refuser. Le texte d'origine reste visible barré jusqu'à votre décision, et l'agent peut joindre une explication au fil de la suggestion.
+- Les [commentaires](/fr/editor/collaborate#comments) laissent un retour ou une question ancrée à un texte précis sans modifier la page.
-Exemples d'invites :
+Exemples de prompts :
- `review this page and leave suggestions`
- `comment on anything that needs more context`
- `suggest ways to make the introduction more concise`
-L'agent utilise la page que vous avez actuellement ouverte, sauf si vous en nommez une autre. Il peut annoter le texte rendu de la page, y compris la prose à l'intérieur des composants, mais pas le frontmatter, les métadonnées de page, la configuration, ni les balises et attributs bruts des composants MDX.
+L'agent utilise la page que vous avez ouverte, sauf si vous en nommez une autre. Il peut annoter le texte rendu de la page, y compris la prose à l'intérieur des composants. Il ne peut pas annoter le frontmatter, les métadonnées de page, la configuration, ni les balises et attributs MDX bruts.
-## Examiner ce que l'agent a modifié
+## Vérifier ce que l'agent a modifié
-À mesure que l'agent modifie vos pages, un panneau **Changed files** apparaît dans le chat. Développez-le pour voir la liste de tous les fichiers modifiés au cours de la session. Cliquez sur n'importe quel fichier pour l'ouvrir en vue de comparaison et comparer les modifications de l'agent à l'original.
+Un panneau **Changed files** apparaît dans le chat pendant que l'agent travaille. Développez-le pour voir tous les fichiers modifiés au cours de la session, et cliquez sur l'un d'eux pour comparer les modifications à l'original en vue diff.
@@ -100,23 +90,23 @@ L'agent utilise la page que vous avez actuellement ouverte, sauf si vous en nomm
-L'agent peut écrire, réécrire, développer et réorganiser le contenu de n'importe quelle page. Il lit votre contenu existant pour respecter votre style et votre structure.
+L'agent peut rédiger, réécrire, développer et réorganiser le contenu de n'importe quelle page. Il lit votre contenu existant pour s'aligner sur votre style et votre structure.
-L'agent peut effectuer une recherche dans l'ensemble de votre référentiel, et pas seulement sur la page ouverte. Utilisez-le pour trouver des informations, repérer des incohérences ou vérifier qu'un contenu existe avant de l'ajouter.
+L'agent peut faire des recherches dans tout votre dépôt, pas seulement dans la page ouverte. Utilisez-le pour trouver une information, repérer des incohérences ou vérifier qu'un contenu existe déjà avant d'en ajouter.
-
-L'agent peut exécuter `grep`, `rg` et d'autres commandes bash sur votre référentiel. Utilisez cette fonction pour des opérations en masse sur de nombreux fichiers.
+L'agent peut exécuter `grep`, `rg` et d'autres commandes bash sur votre dépôt. Utilisez-le pour des opérations en masse qui couvrent de nombreux fichiers.
Exemple : `find every page that mentions the deprecated /v1/auth endpoint`
-### Configurer votre site (mode code)
+### Configurer votre site (code mode)
-Pour les requêtes qui vont au-delà de la modification de pages (configurer l'authentification, gérer des workflows ou modifier les paramètres de déploiement), l'agent passe en mode code. Il écrit et exécute un script sur votre tableau de bord Mintlify en votre nom.
+Pour les demandes qui vont au-delà de la modification de pages (configurer l'authentification, gérer des workflows ou modifier les paramètres du deployment), l'agent passe en code mode. Il écrit et exécute un script sur votre dashboard Mintlify en votre nom.
-Le mode code respecte vos permissions du tableau de bord. Si vous n'avez pas accès à un paramètre dans le tableau de bord, l'agent ne peut pas non plus le modifier.
+Le code mode respecte vos permissions sur le dashboard. Si vous n'avez pas accès à un paramètre dans le dashboard, l'agent ne peut pas le modifier non plus.
-Exemples de prompts qui utilisent le mode code :
+Exemples de prompts qui utilisent le code mode :
- `enable JWT authentication for my site`
- `create a workflow that updates my site when I merge a PR`
@@ -152,9 +142,9 @@ Exemples de prompts qui utilisent le mode code :
@@ -172,4 +162,4 @@ Cliquez sur l'icône d'horloge dans l'en-tête du panneau pour voir vos précéd
-Pour donner à l'agent des consignes persistantes telles que des règles de voix, de terminologie ou des conventions de mise en forme, configurez des instructions d'IA dans les [Paramètres de l'éditeur](/fr/editor/settings#ai-instructions). L'agent suit ces instructions à chaque requête sans que vous ayez besoin de les répéter.
+Pour donner à l'agent des consignes persistantes, comme des règles de voix, une terminologie ou des conventions de mise en forme, configurez des instructions d'IA dans les [paramètres de l'éditeur](/fr/editor/settings#ai-instructions). L'agent suit ces instructions à chaque demande sans que vous ayez à les répéter.
diff --git a/fr/editor/branching-and-publishing.mdx b/fr/editor/branching-and-publishing.mdx
deleted file mode 100644
index dd8af331d..000000000
--- a/fr/editor/branching-and-publishing.mdx
+++ /dev/null
@@ -1,264 +0,0 @@
----
-title: "Branches et publication"
-description: "Comprenez comment les branches et règles de protection déterminent ce qui se passe à la publication, et gérez le workflow de relecture et de déploiement."
-keywords: ["editor", "branch", "publish", "pull request", "preview", "git", "merge", "deploy"]
----
-
-L'éditeur web enregistre automatiquement tout ce que vous tapez, mais vos modifications ne sont mises en ligne que lorsque vous choisissez de les publier.
-
-Ce qui se passe lors de la publication dépend de deux choses : **la branche sur laquelle vous vous trouvez** et **si cette branche exige des pull requests**.
-
-
-
-## Enregistrement vs publication
-
-
-
-**L'enregistrement** est automatique. Mintlify stocke vos modifications sur ses serveurs et les conserve à travers les onglets du navigateur, les appareils et les coupures réseau.
-
-**La publication** valide vos modifications dans votre référentiel Git. Cliquez sur **Publish** dans la barre d'outils pour ouvrir le menu de publication, enregistrer vos modifications en tant que commit Git et créer une pull request.
-
-L'éditeur suit les éléments suivants comme modifications en attente :
-
-- Modifications de contenu dans les pages
-- Pages nouvelles ou supprimées
-- Modifications de la structure de navigation
-- Téléversements de médias
-- Mises à jour de configuration
-
-
-
-## Ce qui se passe lorsque vous publiez
-
-
-
-Les actions disponibles lorsque vous cliquez sur le bouton de publication dépendent de votre branche actuelle et de la présence de règles de protection de branche imposant des pull requests.
-
-| Type de branche | Protection de branche | Actions disponibles |
-|-------------|-------------------|-------------------|
-|
-
-## Quand utiliser une branche
-
-
-
-**Modifiez directement sur votre branche de déploiement** si vous n'utilisez pas de workflow basé sur Git.
-
-**Créez une branche** lorsque vous utilisez un workflow basé sur des branches dans lequel chaque modification de votre contenu se fait sur une branche distincte.
-
-
-
-## Créer des branches et changer de branche
-
-
-
-
-
-### Créer une branche
-
-
-
-1. Cliquez sur le nom de la branche dans la barre d'outils de l'éditeur.
-1. Cliquez sur **Create new branch**.
-1. Si vous avez des modifications en attente, choisissez si vous voulez les transférer vers la nouvelle branche ou les laisser sur la branche actuelle.
-1. Saisissez un nom et cliquez sur **Create branch**.
-
-
-
-### Changer de branche
-
-
-
-1. Cliquez sur le nom de la branche dans la barre d'outils.
-1. Recherchez ou faites défiler jusqu'à la branche souhaitée.
-1. Cliquez sur la branche pour y basculer.
-
-
-
-## Prévisualiser vos modifications
-
-
-
-Chaque fois que vous enregistrez des modifications sur une branche de fonctionnalité, Mintlify génère un déploiement de prévisualisation, une URL temporaire où vos modifications s'affichent exactement comme une fois publiées.
-
-
-
-1. Cliquez sur **Publish** dans la barre d'outils de l'éditeur.
-1. Dans le menu de publication, cliquez sur l'URL d'aperçu. Le format de l'URL est `organization-branch-name.mintlify.site`.
-
-
-
-
-
-Copiez l'URL et envoyez-la aux relecteurs. L'aperçu se met à jour automatiquement chaque fois que vous enregistrez sur la branche.
-
-
-
-### Restreindre l'accès aux aperçus
-
-
-
-Les URL d'aperçu sont publiquement accessibles par défaut. Pour restreindre l'accès aux membres de votre organisation Mintlify, activez l'authentification d'aperçu sur la page [Add-ons](https://app.mintlify.com/products/addons) de votre tableau de bord.
-
-
-
-Pour inviter un coéquipier sur une page spécifique d'une branche, copiez l'URL depuis la barre d'adresse de votre navigateur et partagez-la. Toute personne ayant accès à votre organisation Mintlify peut ouvrir le lien directement dans sa session de l'éditeur.
-
-Le format de l'URL est :
-
-```text
-https://app.mintlify.com/{org}/{project}/editor/{branch}/~/{filepath}
-```
-
-Par exemple : `https://app.mintlify.com/acme/docs/editor/main/~/guides/quickstart.mdx`
-
-
-
-## Examiner et fusionner les pull requests
-
-
-
-Lorsqu'une pull request est ouverte pour la branche actuelle, le menu de publication affiche un panneau de relecture avec :
-
-- Le titre de la pull request, sa description et si elle est en brouillon.
-- Les branches source et cible.
-- Le nombre de fichiers modifiés.
-- L'exigence d'approbation sur la branche de déploiement : **Approval required**, **Code owner required**, ou aucune exigence.
-- Le statut de relecture actuel : **Approved**, **Changes requested** ou **Awaiting review**.
-
-Cliquez sur le lien de la pull request pour l'ouvrir dans GitHub, GitLab ou Bitbucket.
-
-Une fois qu'un relecteur a approuvé la pull request, cliquez sur **Merge and publish** pour la fusionner et la déployer directement depuis l'éditeur. L'éditeur bascule vers votre branche de déploiement après la fusion.
-
-
-
-### Approuver les pull requests depuis l'éditeur
-
-
-
-Pour les référentiels GitHub, les relecteurs peuvent approuver les pull requests ouvertes dans l'éditeur. Lorsqu'une pull request est ouverte, un bouton **Approve pull request** apparaît dans le panneau de relecture si votre compte a la permission de la relire. Cliquez sur **Approve pull request** lorsque les modifications sont prêtes à fusionner. Le statut de relecture passe à **Approved** et l'action **Merge and publish** devient disponible.
-
-L'action d'approbation n'est pas disponible pour les pull requests en brouillon ou les pull requests que vous avez déjà approuvées. Si vous utilisez GitLab ou Bitbucket, ouvrez la pull request dans votre fournisseur Git pour l'approuver.
-
-
-
-### Examiner les modifications avant la fusion
-
-
-
-Cliquez sur n'importe quel fichier modifié dans le menu de publication pour l'ouvrir en vue de comparaison et comparer votre branche à la version publiée. En mode visuel, vous voyez un diff visuel. En mode source, vous voyez un diff textuel. Les fichiers qui ne peuvent pas afficher de diff, comme les images ou les fichiers supprimés, apparaissent dans la liste mais ne sont pas cliquables.
-
-L'arborescence des fichiers met en évidence les pages modifiées afin que vous puissiez voir d'un coup d'œil les fichiers qu'une [automatisation](/fr/automations) ou un coéquipier a touchés. Les pages non listées qui apparaissent dans le diff de la branche sont également accessibles depuis le menu de publication, même si elles n'apparaissent pas dans la navigation de votre site.
-
-
-
-### Ouvrir une exécution d'automatisation dans l'éditeur
-
-
-
-Lorsqu'une [automatisation](/fr/automations) ouvre une pull request, vous pouvez accéder directement à l'éditeur sur la branche de l'automatisation depuis l'interface de relecture des exécutions ou depuis sa notification Slack :
-
-- Depuis la page **Automation Runs** de votre dashboard, cliquez sur **Open in editor** sur une exécution terminée.
-- Depuis une notification Slack, cliquez sur le lien **View changes**.
-
-Chacun de ces points d'entrée ouvre l'éditeur sur la branche de l'automatisation avec les pages modifiées présélectionnées dans le menu de publication. Vous pouvez examiner le diff et fusionner ou demander des modifications sans quitter l'éditeur.
-
-
-
-### Publication simultanée
-
-
-
-Une seule publication peut avoir lieu à la fois par branche. Si un autre membre de l'équipe publie sur la même branche, attendez que la publication en cours soit terminée avant de réessayer.
-
-
-
-### Titres et descriptions des pull requests
-
-
-
-Si votre organisation exige des pull requests, vous pouvez saisir un titre et une description au moment de publier. Si vous laissez l'un ou l'autre vide, l'éditeur utilise un message par défaut qui liste les fichiers que vous avez créés, mis à jour, déplacés ou supprimés.
-
-
-
-## Résoudre les conflits
-
-
-
-Des conflits surviennent lorsque votre branche et la branche de déploiement comportent des modifications incompatibles dans les mêmes fichiers. Par exemple, lorsque vous et un coéquipier avez modifié les mêmes lignes d'un fichier ou déplacé un fichier vers des emplacements différents.
-
-L'éditeur affiche un avertissement lorsque des conflits bloquent la publication. Suivez les invites pour choisir quelle version de chaque section en conflit conserver.
-
-
-
-## Collaborer en temps réel
-
-
-
-Lorsque plusieurs personnes ouvrent la même page sur la même branche, elles éditent ensemble en temps réel. Le curseur et les modifications de chaque personne sont visibles par tous, avec les avatars affichés dans la barre d'outils.
-
-- Les modifications de tous les collaborateurs fusionnent automatiquement. Deux personnes éditant la même section ne créeront pas de conflits.
-- L'annulation n'affecte que vos propres modifications.
-- Si vous perdez votre connexion, les modifications sont enregistrées localement et se synchronisent à la reconnexion.
-
-Lorsque l'[agent Mintlify](/fr/agent) modifie une page via l'API ou MCP, il apparaît dans l'éditeur comme n'importe quel autre collaborateur. Vous voyez l'avatar de l'agent dans la barre d'outils et un curseur en direct à son dernier emplacement d'édition. Le curseur disparaît automatiquement une fois que l'agent a terminé.
-
-
-
-## Synchronisation Git
-
-
-
-Lorsque quelqu'un pousse des modifications vers votre référentiel depuis l'extérieur de l'éditeur, l'éditeur intègre ces modifications automatiquement.
-
-Les modifications qui ne se chevauchent pas s'appliquent automatiquement. Si une modification distante et votre modification locale affectent la même partie d'une page, l'éditeur met en évidence le conflit pour que vous puissiez le résoudre.
-
-
-
-## Signature des commits
-
-
-
-Signez les commits avec votre compte GitHub en l'autorisant dans vos [paramètres de compte](https://app.mintlify.com/settings/account). Sans autorisation, l'application GitHub Mintlify signe les commits effectués dans l'éditeur web.
-
-Pour une référence sur la correspondance entre les actions de l'éditeur et les opérations Git, consultez [Notions essentielles de Git](/fr/editor/git-essentials#how-the-editor-maps-to-git).
diff --git a/fr/editor/collaborate.mdx b/fr/editor/collaborate.mdx
new file mode 100644
index 000000000..442fc8036
--- /dev/null
+++ b/fr/editor/collaborate.mdx
@@ -0,0 +1,82 @@
+---
+title: "Collaborer dans l'éditeur"
+sidebarTitle: "Collaborer"
+description: "Laissez des commentaires, proposez des modifications sous forme de suggestions et travaillez avec vos collègues en temps réel dans l'éditeur."
+keywords: ["comments", "suggestions", "collaboration", "review", "mentions", "real time"]
+---
+
+Travaillez avec votre équipe sur une page en la commentant, en y proposant des suggestions ou en la modifiant ensemble en même temps.
+
+
+
+## Commentaires
+
+
+
+Les commentaires vous permettent de laisser un retour sur un texte précis sans modifier le contenu.
+
+**Les commentaires n'atteignent jamais votre dépôt.** Ils n'existent que dans l'éditeur et ne sont jamais inclus dans le site publié ni commités dans Git.
+
+Pour ajouter un commentaire, surlignez du texte et cliquez sur l'icône
+
+
+
+Tous les [rôles](/fr/dashboard/roles) peuvent commenter et répondre, y compris les viewers. Seuls les editors et les admins peuvent résoudre les fils. Résoudre un fil le retire de la barre latérale et supprime le surlignage de la page.
+
+Vous pouvez supprimer vos propres commentaires et les admins peuvent supprimer n'importe quel commentaire. Supprimer le premier commentaire d'un fil supprime le fil entier.
+
+Saisissez `@` pour mentionner un collègue. Il doit être membre de votre organisation et reçoit une notification par e-mail.
+
+Si votre branch comporte une pull request ouverte, Mintlify ajoute à sa description un résumé des fils non résolus, avec un lien vers chaque commentaire. Le résumé se met à jour au fil des changements.
+
+
+
+## Suggestions
+
+
+
+Les suggestions proposent une modification tout en conservant le contenu actuel, de sorte qu'un collègue puisse l'accepter ou la refuser.
+
+Les editors et les admins peuvent accepter ou refuser n'importe quelle suggestion. Les viewers ne le peuvent pas.
+
+Pour faire une suggestion, surlignez du texte et cliquez sur le bouton
+
+## Interroger l'agent Mintlify
+
+
+
+Mentionnez `@mintlify` dans un commentaire, une suggestion ou une réponse pour interroger l'[agent de l'éditeur](/fr/editor/agent) au sujet de la page en cours. L'agent s'exécute en arrière-plan avec la page, le fil et la branch comme contexte, puis publie sa réponse dans le même fil.
+
+```text
+@mintlify does this endpoint support pagination?
+@mintlify are there any pages that contradict this?
+```
+
+L'agent fonctionne en lecture seule lorsqu'il répond à des commentaires. Il peut faire des recherches dans votre documentation, lire des pages, consulter du contenu web et charger des skills, mais il ne peut ni modifier le contenu, ni créer des suggestions, ni publier. Pour apporter des modifications, ouvrez directement l'[agent de l'éditeur](/fr/editor/agent).
+
+Les mentions fonctionnent sur les pages privées pour les membres qui y ont déjà accès. Chaque réponse est décomptée de votre utilisation de l'agent de l'éditeur.
+
+
+
+## Édition en temps réel
+
+
+
+Lorsque plusieurs personnes ouvrent la même page sur la même branch, elles la modifient ensemble. Le curseur et les modifications de chacun sont visibles par tous, avec des avatars dans la barre d'outils.
+
+- Les modifications de tous les collaborateurs fusionnent automatiquement. Deux personnes qui modifient la même section ne créent pas de conflit.
+- L'annulation n'affecte que vos propres modifications.
+- Si vous perdez la connexion, vos modifications sont enregistrées localement et synchronisées à la reconnexion.
+
+Lorsque l'[agent Mintlify](/fr/agent) modifie une page via l'API ou MCP, il apparaît comme n'importe quel autre collaborateur, avec un avatar et un curseur en direct sur sa modification la plus récente. Le curseur disparaît quand l'agent a terminé.
diff --git a/fr/editor/comments.mdx b/fr/editor/comments.mdx
deleted file mode 100644
index fea32cf3c..000000000
--- a/fr/editor/comments.mdx
+++ /dev/null
@@ -1,108 +0,0 @@
----
-title: "Commentaires"
-description: "Laissez des commentaires en ligne sur les pages dans l'éditeur pour donner votre avis, poser des questions et discuter des modifications avec votre équipe."
-keywords: ["éditeur", "commentaires", "collaboration", "retours", "mentions", "fils de discussion"]
----
-
-Les commentaires permettent à vous et votre équipe de laisser des retours sur un texte spécifique d'une page sans modifier le contenu. Utilisez les commentaires pour poser des questions, signaler des problèmes ou discuter des changements avant de les publier.
-
-Les commentaires n'existent qu'à l'intérieur de l'éditeur. Ils ne sont jamais inclus dans le site publié ni committés dans votre dépôt.
-
-Tous les [rôles](/fr/dashboard/roles)—viewers, editors et admins—peuvent laisser des commentaires et y répondre. Seuls les editors et admins peuvent résoudre les fils de commentaires.
-
-Si votre branche a une pull request ouverte, Mintlify ajoute un résumé des fils de commentaires non résolus à la description de la pull request. Le résumé liste les fichiers avec des commentaires ouverts, le premier commentaire de chaque fil et un lien pour accéder au commentaire dans l'éditeur.
-
-Le résumé se met à jour lorsque vous ajoutez, résolvez ou supprimez un commentaire.
-
-
- ## Ajouter un commentaire
-
-
-1. Surlignez le texte sur lequel vous souhaitez commenter.
-2. Cliquez sur l'icône
-
-
-
-
-
-Pour ouvrir un fil de commentaires, cliquez sur le texte surligné ou sur le fil dans la barre latérale des commentaires. Saisissez votre réponse et appuyez sur Enter pour la soumettre.
-
-
-
-
-
-
-
- ## Mentionner un coéquipier
-
-
-Tapez `@` dans un commentaire ou une réponse pour mentionner un coéquipier. Les personnes doivent être membres de votre organisation pour que vous puissiez les mentionner.
-
-Les coéquipiers mentionnés reçoivent une notification par e-mail.
-
-
- ## Demander à l'agent Mintlify
-
-
-Mentionnez `@mintlify` dans un commentaire, une [suggestion](/fr/editor/suggestions) ou une réponse pour poser une question à l'[agent de l'éditeur](/fr/editor/agent) à propos de la page actuelle. L'agent s'exécute de manière asynchrone avec la page, le fil et la branche comme contexte, puis publie sa réponse en tant que nouvelle réponse dans le même fil.
-
-Utilisez les mentions `@mintlify` pour poser des questions telles que :
-
-- `@mintlify does this endpoint support pagination?`
-- `@mintlify is this the recommended way to configure webhooks?`
-- `@mintlify are there any pages that contradict this?`
-
-L'agent s'exécute en mode lecture seule lorsqu'il répond aux commentaires. Il peut effectuer une recherche dans votre documentation, lire des pages, récupérer du contenu web et charger des skills, mais il ne peut pas modifier le contenu, créer des suggestions ni publier de changements. Pour effectuer des modifications, ouvrez directement l'[agent de l'éditeur](/fr/editor/agent).
-
-Les mentions `@mintlify` fonctionnent sur les pages privées pour les membres qui y ont déjà accès. Chaque réponse de l'agent est comptabilisée dans votre utilisation de l'agent de l'éditeur.
-
-
- ## Résoudre un commentaire
-
-
-Les editors et admins peuvent résoudre les fils lorsqu'une discussion est terminée.
-
-Cliquez sur l'icône de coche pour résoudre un fil. Les fils résolus sont retirés de la barre latérale des commentaires et le surlignage est effacé de la page.
-
-
-
-
-
-
-
- ## Supprimer un commentaire
-
-
-Cliquez sur l'icône de corbeille à côté d'un commentaire pour le supprimer. Supprimer le premier commentaire d'un fil supprime l'intégralité du fil.
-
-Vous pouvez supprimer vos propres commentaires. Les admins peuvent supprimer n'importe quel commentaire.
diff --git a/fr/editor/configurations.mdx b/fr/editor/configurations.mdx
deleted file mode 100644
index 97b69c931..000000000
--- a/fr/editor/configurations.mdx
+++ /dev/null
@@ -1,274 +0,0 @@
----
-title: "Configurations"
-description: "Modifiez identité de marque, apparence, navigation et paramètres du site depuis le panneau Configurations de l'éditeur web Mintlify, en temps réel."
-keywords: ["editor", "configurations", "settings", "branding", "theme"]
-boost: 3
----
-
-Configurez l'identité de marque, l'apparence et les fonctionnalités de votre site depuis le panneau **Site configurations** de l'éditeur web. Les modifications de configuration se synchronisent en temps réel avec les autres éditeurs sur la même branche, afin que votre équipe voie toujours les derniers paramètres.
-
-Pour ouvrir le panneau, cliquez sur l'icône de configurations
-
-
-
-Le panneau regroupe les paramètres en sections qui correspondent aux propriétés de premier niveau de votre [`docs.json`](/fr/organize/settings).
-
-
-
-## Général
-
-
-
-Définissez l'identité de votre site et la façon dont il apparaît aux visiteurs.
-
-- **Name** : Le nom de votre projet. Apparaît dans les onglets du navigateur et les résultats de recherche.
-- **Description** : Brève présentation de votre projet. Utilisée pour le SEO et l'AEO.
-
-
-
-## Branding
-
-
-
-Téléversez les éléments qui identifient votre site.
-
-- **Logo** : Le logo de votre marque. Téléversez des fichiers PNG ou JPG. Définissez des versions distinctes pour les modes clair et sombre, ainsi qu'une URL de redirection facultative. Pour utiliser un logo SVG, ajoutez le fichier à votre référentiel et référencez son chemin dans votre [`docs.json`](/fr/organize/settings-appearance#logos).
-- **Favicon** : Petite icône qui apparaît dans les onglets du navigateur. Téléversez des fichiers ICO, PNG, GIF ou JPG. Définissez des versions distinctes pour les modes clair et sombre si nécessaire.
-
-
-
-## Apparence
-
-
-
-Contrôlez l'identité visuelle et la palette de couleurs de votre site.
-
-- **Theme** : Choisissez un [thème](/fr/customize/themes) pour l'apparence générale de votre site.
-- **Primary color** : La couleur d'accent principale utilisée sur l'ensemble de votre site pour les liens, les boutons et les mises en valeur.
-- **Light color** : Couleur d'accent utilisée en mode sombre. Son application varie selon le thème.
-- **Dark color** : Couleur d'accent utilisée en mode clair. Son application varie selon le thème.
-- **Background color** : Couleurs d'arrière-plan personnalisées pour les modes clair et sombre.
-- **Icon library** : Bibliothèque d'icônes utilisée pour toutes les propriétés d'icône. Par défaut : `fontawesome`.
-- **Strict appearance** : Verrouille le site sur un seul mode d'apparence et masque le bouton de bascule de thème.
-- **Default appearance** : Définit si votre site se charge par défaut en mode `system`, `light` ou `dark`.
-- **Background decoration** : Applique un style visuel (`gradient`, `grid` ou `windows`) à votre arrière-plan.
-- **Background image** : Image d'arrière-plan facultative. Définissez une image unique ou des versions distinctes pour les modes clair et sombre.
-
-
-
-## Typographie
-
-
-
-Remplacez les polices par défaut par la typographie de votre marque.
-
-- **Font family** : Toute famille [Google Fonts](https://fonts.google.com/) fonctionne directement. Pour une police auto-hébergée, fournissez une URL source et un format (`woff` ou `woff2`).
-- **Weight** : Généralement `400` pour le texte normal et `700` pour le gras. Les polices variables prennent en charge des graisses précises comme `550`.
-- **Heading font** : Surcharge facultative appliquée à tous les titres (`h1` à `h6`).
-- **Body font** : Surcharge facultative appliquée au corps de texte et au reste de la page.
-
-
-
-Ajoutez des éléments de navigation en haut de votre site.
-
-- **Primary button** : L'appel à l'action principal dans votre en-tête. Définissez le type, le label et l'URL de destination.
-- **Navbar links** : Liens de navigation supplémentaires dans votre en-tête. Chaque lien comporte un texte et une URL.
-
-
-
-Ajoutez des liens et des comptes de réseaux sociaux au pied de page de votre site.
-
-- **Social links** : Profils sur des plateformes comme GitHub, X, LinkedIn, Discord, YouTube et Slack.
-- **Footer columns** : Activez pour organiser les liens du pied de page en jusqu'à quatre colonnes avec des titres personnalisés.
-
-
-
-Affichez une barre d'annonce en haut de chaque page.
-
-- **Content** : Le texte de la bannière. Prend en charge la mise en forme MDX de base, comme les liens, le gras et l'italique. Les composants personnalisés ne sont pas pris en charge.
-- **dismissible** : Affiche un bouton de fermeture sur le côté droit de la bannière.
-- **Type** : Style visuel. `info` utilise la couleur de marque principale, `warning` utilise un arrière-plan ambré et `critical` utilise un arrière-plan rouge. Par défaut : `info`.
-- **Color** : Remplace la couleur d'arrière-plan de la bannière par une couleur hexadécimale personnalisée. Définissez des valeurs distinctes pour les modes clair et sombre pour des couleurs adaptées au thème.
-
-
-
-## Vignette
-
-
-
-Personnalisez les vignettes de page et les aperçus pour les réseaux sociaux.
-
-- **Background** : Image d'arrière-plan personnalisée pour les vignettes.
-- **Appearance** : Affiche les vignettes en mode `light` ou `dark`. Si non défini, les vignettes sont générées automatiquement à partir des couleurs de votre thème.
-- **Font** : Police personnalisée pour le texte des vignettes.
-
-
-
-## Contenu
-
-
-
-Personnalisez la façon dont le contenu apparaît sur votre site.
-
-- **Page eyebrow** : Affiche de petits labels au-dessus des titres de page. Choisissez `section` ou `breadcrumbs`.
-- **Timestamps** : Affiche la date de dernière modification du contenu sur toutes les pages.
-- **LaTeX** : Charge les feuilles de style LaTeX (KaTeX) pour le rendu des notations mathématiques.
-
-
-
-## Blocs de code
-
-
-
-Configurez la coloration syntaxique et le comportement des blocs de code.
-
-- **Code block theme** : Adaptez au mode clair/sombre du site avec `system`, utilisez toujours un thème sombre avec `dark`, ou choisissez un thème [Shiki](https://shiki.style/) personnalisé.
-- **Custom code languages** : Enregistrez des langages de coloration syntaxique supplémentaires.
-
-
-
-Configurez les actions rapides présentées dans le menu contextuel de la page.
-
-- **Options** : Liste déroulante à sélection multiple d'actions comme `copy`, `view` et l'ouverture de la page dans `chatgpt`, `claude`, `cursor` et d'autres assistants IA.
-- **Display** : Où afficher les options. `header` (par défaut) les affiche dans le menu contextuel en haut de page ; `toc` les affiche dans la barre latérale de la table des matières.
-
-
-
-Ajustez le comportement de la navigation sur votre site.
-
-- **drilldown** : Navigue automatiquement vers la première page lorsqu'un utilisateur clique sur un groupe de navigation.
-
-
-
-## Recherche
-
-
-
-Personnalisez l'expérience de recherche et les retours utilisateur.
-
-- **Search placeholder** : Le texte qui apparaît dans le champ de recherche avant que les utilisateurs ne tapent. La valeur par défaut est `Search or ask`.
-- **Feedback** : Affiche les boutons pouce vers le haut et pouce vers le bas, ou un lien « Suggest edits » sur chaque page.
-
-
-
-## Référence d'API
-
-
-
-Documentez les endpoints de votre API.
-
-- **OpenAPI specs** : Ajoutez des fichiers de spécification OpenAPI pour générer des pages de référence d'API.
-- **AsyncAPI specs** : Ajoutez des fichiers de spécification AsyncAPI pour générer des pages de référence d'API.
-- **MDX server** : Endpoints MDX server personnalisés pour le bac à sable d'API.
-- **Playground display** : Affichez le bac à sable d'API interactif, le bac à sable d'API simple ou aucun bac à sable d'API.
-- **Proxy server** : Activez ou désactivez le serveur proxy pour les requêtes d'API.
-- **`mdx.schema`** : Détermine si la section de schéma s'affiche sur les pages de référence d'API.
-
-
-
-## Redirections
-
-
-
-Utilisez la section **Redirects** pour ajouter, modifier, rechercher et supprimer des redirections sans modifier manuellement votre fichier `docs.json`. Les redirections envoient les utilisateurs d'anciennes URL vers de nouvelles, ce qui est utile lorsque vous renommez des pages ou réorganisez votre site. Pour plus d'informations, consultez [Redirections](/fr/create/redirects).
-
-Chaque redirection comporte les champs suivants :
-
-- **Source** : Le chemin à rediriger, comme `/old-path`. Prend en charge les caractères génériques.
-- **Destination** : Le chemin de destination, comme `/new-path`. Prend en charge les caractères génériques.
-- **Status** : Le code d'état HTTP de la redirection.
- - `308` : Redirection permanente. À utiliser pour le contenu qui a été déplacé définitivement. C'est le statut par défaut.
- - `307` : Redirection temporaire. À utiliser lorsque le déplacement est temporaire.
-
-
-
-
-
-
-Pour ajouter une redirection :
-
-1. Cliquez sur **Add redirect**.
-2. Saisissez la source et la destination.
-3. Cliquez sur **Save**.
-
-Pour modifier ou supprimer une redirection existante, survolez la ligne et utilisez l'icône d'édition inline ou le **X** pour la supprimer.
-
-
-
-## SEO
-
-
-
-Configurez les balises méta et l'indexation pour les moteurs de recherche.
-
-- **metatags** : Balises `` personnalisées appliquées à l'ensemble de votre site. Ajoutez des paires clé-valeur pour des balises comme `og:image` ou `twitter:card`.
-- **Indexing** : Choisissez d'indexer ou non les pages masquées.
-
-
-
-## Analytics
-
-
-
-Connectez des plateformes d'analytics pour suivre le comportement des visiteurs. Les fournisseurs pris en charge incluent Amplitude, Mixpanel, Heap, Google Analytics, Google Tag Manager, PostHog, Plausible, Fathom, Segment, Hightouch, Hotjar, LogRocket, Microsoft Clarity, Intercom, Clearbit, et plus encore.
-
-Chaque entrée s'affiche sous forme de ligne inline. Utilisez l'icône **X** pour supprimer une intégration.
-
-
-
-## Page 404
-
-
-
-Personnalisez l'expérience lorsqu'un utilisateur arrive sur une page manquante.
-
-- **Redirect to home** : Lorsqu'activé, les pages manquantes redirigent vers votre page d'accueil. Lorsque désactivé, le site affiche une page 404 et vous pouvez personnaliser le titre et la description ci-dessous.
-- **Title** : Titre affiché sur la page 404.
-- **Description** : Sous-titre affiché sur la page 404.
-
-
-
-## Variables
-
-
-
-Définissez des variables personnalisées réutilisables dans tout votre contenu. Chaque variable est une paire clé-valeur. Utilisez l'icône **X** pour supprimer une variable.
diff --git a/fr/editor/git-essentials.mdx b/fr/editor/git-essentials.mdx
deleted file mode 100644
index 96b5a746a..000000000
--- a/fr/editor/git-essentials.mdx
+++ /dev/null
@@ -1,84 +0,0 @@
----
-title: "Notions essentielles de Git pour l'éditeur"
-sidebarTitle: "Notions essentielles de Git"
-description: "Comprenez les concepts de contrôle de version Git derrière l'éditeur Mintlify : branches, commits, pull requests et workflows de fusion."
-keywords: ["git", "version control", "web editor", "branches", "commits", "pull requests", "PRs"]
----
-
-Git vous permet de contrôler et de suivre les modifications apportées aux fichiers. C'est le système de contrôle de version qui sous-tend les workflows basés sur des branches, où vous gérez votre contenu de la même manière que n'importe quelle autre base de code.
-
-L'éditeur web gère les opérations Git à votre place. Comprendre quelques concepts clés vous aide à tirer le meilleur parti de l'éditeur et à collaborer efficacement avec votre équipe.
-
-
-
-## Ce que Git fait pour votre contenu
-
-
-
-Git suit chaque modification apportée à votre contenu. Il enregistre ce qui a changé, qui l'a modifié, quand et pourquoi. Cela vous permet de :
-
-- Voir l'historique complet de n'importe quelle page.
-- Annuler des modifications en revenant à une version précédente.
-- Travailler sur des mises à jour sans affecter votre site en production.
-- Examiner les modifications avant leur mise en ligne.
-
-Votre référentiel est l'ensemble des fichiers et de leur historique qui composent votre site. L'éditeur se connecte à ce référentiel pour synchroniser et publier votre contenu.
-
-
-
-## Concepts clés
-
-
-
-Voici les concepts Git que vous rencontrerez le plus souvent en utilisant l'éditeur web.
-
-
-
-## Correspondance entre l'éditeur et Git
-
-
-
-Chaque action dans l'éditeur web correspond à une opération Git. Voici la référence complète :
-
-| Action dans l'éditeur | Opération Git |
-|---|---|
-| Modifier une page | Les modifications sont enregistrées automatiquement sur les serveurs Mintlify. Pas encore de commit Git. |
-| Publier sur votre branche de déploiement | `git commit` et `git push`. Déclenche un déploiement. |
-| Save in branch | `git commit` sur la branche de fonctionnalité actuelle. |
-| Create pull request | `git push` et ouvre une pull request vers votre branche de déploiement. |
-| Merge and publish | Fusionne la pull request et déclenche un déploiement. |
-| Créer une branche | `git checkout -b
- ## Ouvrir l'éditeur
-
+Utilisez l'éditeur pour rédiger et publier de la documentation dans votre navigateur. L'éditeur repose sur un workflow docs-as-code dans lequel Git conserve toutes vos modifications. Votre travail est enregistré sous forme de commits dans votre dépôt et l'éditeur gère les opérations Git à votre place.
-Ouvrez l'éditeur depuis l'onglet [Editor](https://app.mintlify.com/editor) de votre dashboard Mintlify. Tout membre de votre organisation peut ouvrir l'éditeur ; ce que vous pouvez y faire dépend de votre [rôle](/fr/dashboard/roles). Les admins et editors peuvent éditer et publier, et les viewers peuvent parcourir le contenu et laisser des [commentaires](/fr/editor/comments) ou des [suggestions](/fr/editor/suggestions).
+L'éditeur se charge par défaut lorsque vous ouvrez votre [dashboard](https://app.mintlify.com). Tout membre de votre organisation peut l'ouvrir, mais certaines actions dépendent de votre [rôle](/fr/dashboard/roles). Les admins et les editors peuvent modifier et publier. Les viewers peuvent parcourir le contenu et laisser des [commentaires et des suggestions](/fr/editor/collaborate).
@@ -21,78 +19,84 @@ Ouvrez l'éditeur depuis l'onglet [Editor](https://app.mintlify.com/editor) de v
-**Les modifications sont enregistrées automatiquement.** Au fur et à mesure que vous tapez, l'éditeur enregistre votre travail. Vos modifications sont conservées entre les onglets, les appareils et les coupures réseau. Les modifications ne sont mises en ligne que lorsque vous les publiez.
+**Les modifications sont enregistrées automatiquement, mais enregistrer n'est pas publier.** Au fur et à mesure que vous écrivez, l'éditeur enregistre votre travail. Vos modifications persistent d'un onglet, d'un appareil et d'une coupure réseau à l'autre. Pour qu'une modification atteigne votre site publié, vous devez la [publier](/fr/editor/publish).
-**Git reste synchronisé.** Lorsqu'une autre personne pousse des modifications vers votre référentiel depuis l'extérieur de l'éditeur, ces modifications apparaissent automatiquement dans l'éditeur. Vous n'avez pas besoin de faire un pull ni d'actualiser. L'éditeur fusionne les modifications sans conflit et met en évidence les éléments nécessitant votre attention.
+**Publier écrit dans Git.** Lorsque vous publiez, l'éditeur commit vos modifications dans votre dépôt. Si vous publiez sur votre deployment branch, votre site publié est mis à jour immédiatement. Sur une feature branch, vous pouvez choisir si la publication met à jour votre site immédiatement ou ouvre une pull request pour révision.
-
+
-
+
+
-- **Barre supérieure** : Utilisez la barre supérieure pour contrôler la branche sur laquelle vous travaillez, accéder à l'agent, prévisualiser et publier les modifications.
-- **Barre latérale de navigation** : Sélectionnez une page à modifier, créez de nouvelles pages et gérez la structure du site.
+* **Barre supérieure** : Utilisez la barre supérieure pour choisir la branch sur laquelle vous travaillez, accéder à l'agent, prévisualiser et publier vos modifications.
+* **Barre latérale** : Utilisez la barre latérale pour sélectionner les pages à modifier, créer de nouvelles pages et gérer la structure de votre site.
+ * **Home** : L'arborescence de fichiers de votre projet. Les pages dans **Personal** vous sont privées. Les pages dans **Workspace** sont publiques pour votre organisation.
+ * **Publishing** : La structure de navigation de votre site. Organisez les pages telles que vous voulez qu'elles apparaissent sur votre site.
-
-## La disposition de l'éditeur
+## Disposition de l'éditeur
-
-
+
+
-- **Barre supérieure** : Utilisez la barre supérieure pour contrôler la branche sur laquelle vous travaillez, accéder à l'agent, prévisualiser et publier les modifications.
-- **Barre latérale de navigation** : Sélectionnez une page à modifier, créez de nouvelles pages et gérez la structure du site.
+* **Barre supérieure** : Utilisez la barre supérieure pour choisir la branch sur laquelle vous travaillez, accéder à l'agent, prévisualiser et publier vos modifications.
+* **Barre latérale** : Utilisez la barre latérale pour sélectionner les pages à modifier, créer de nouvelles pages et gérer la structure de votre site.
+ * **Home** : L'arborescence de fichiers de votre projet. Les pages dans **Personal** vous sont privées. Les pages dans **Workspace** sont publiques pour votre organisation.
+ * **Publishing** : La structure de navigation de votre site. Organisez les pages telles que vous voulez qu'elles apparaissent sur votre site.
-
+
- Comment les branches et les règles de protection déterminent ce qui se passe lorsque vous publiez, et comment gérer le processus de revue par pull request.
-
-
-
- Laissez des retours, posez des questions et discutez des modifications avec votre équipe.
-
-
-
- Proposez des modifications que vos coéquipiers peuvent examiner, accepter ou rejeter.
-
-
-
- Modifier des pages, rechercher dans votre contenu, ajuster les paramètres et configurer votre site depuis une interface de chat.
-
+**Le mode visuel** affiche votre page au fur et à mesure que vous écrivez. Appuyez sur / pour ouvrir le menu des composants et en insérer.
-
- Ajoutez de nouvelles pages et mettez à jour celles existantes.
-
+**Le mode source** vous donne un accès direct au MDX. Utilisez-le pour contrôler précisément les propriétés des composants et le frontmatter.
-
- Réordonnez les pages et gérez la structure du site.
-
+Les deux modes modifient le même fichier. Passez de l'un à l'autre avec Cmd + Shift + S (macOS) ou Ctrl + Shift + S (Windows).
-
- Prévisualisez votre site en temps réel pendant que vous éditez, sans attendre de build.
-
+Pour connaître les composants que vous pouvez insérer, consultez [Composants](/fr/components). Pour la syntaxe MDX, consultez [Mettre en forme le texte](/fr/create/text) et [Mettre en forme le code](/fr/create/code).
-
- Configurez le branding, les couleurs et les fonctionnalités de votre site.
-
+
- Gagnez du temps avec les raccourcis clavier.
-
+Comprendre quelques notions de Git vous aide à tirer le meilleur parti de l'éditeur.
+
+
+
+ Un instantané enregistré de vos modifications à un moment donné, accompagné d'un message décrivant ce qui a changé. Publier crée un commit.
+
+
+ Une ligne de travail distincte. Votre site publié est compilé depuis une **deployment branch**, généralement `main`. Les autres branches, parfois appelées **feature branches**, vous permettent de travailler sans affecter votre site publié. Rien sur une feature branch n'est publié tant que vous ne l'avez pas fusionnée.
+
+
+ Une proposition de fusionner une branch dans une autre, afin que votre équipe puisse examiner les modifications avant leur mise en ligne. Votre équipe examine et fusionne les pull requests dans GitHub, GitLab ou Bitbucket, ou [depuis l'éditeur](/fr/editor/review).
+
+
+ Combiner les modifications d'une branch dans une autre. Fusionner dans votre deployment branch publie ces modifications.
+
+
+ Deux branches avec des modifications incompatibles sur les mêmes lignes. L'éditeur vous invite à choisir la version à conserver afin de résoudre les conflits avant la fusion.
+
+
+ Une comparaison entre deux versions d'un fichier. L'éditeur affiche un diff de vos modifications en attente avant que vous ne publiiez.
+
+
+
+| Action dans l'éditeur | Opération Git |
+|---|---|
+| Modifier une page | Enregistrement automatique. Pas encore de commit. |
+| Publier sur votre deployment branch | `git commit` et `git push`. Déclenche un déploiement. |
+| Save in branch | `git commit` sur la feature branch actuelle. |
+| Create pull request | `git push` et ouvre une pull request vers votre deployment branch. |
+| Merge and publish | Fusionne la pull request et déclenche un déploiement. |
+| Créer une branch | `git checkout -b ` |
+| Changer de branch | `git checkout ` |
+| Push externe ou mise à jour via la CLI | Les modifications entrantes sont synchronisées dans l'éditeur via une fusion à trois voies. |
diff --git a/fr/editor/keyboard-shortcuts.mdx b/fr/editor/keyboard-shortcuts.mdx
index 346163ce2..d2d411214 100644
--- a/fr/editor/keyboard-shortcuts.mdx
+++ b/fr/editor/keyboard-shortcuts.mdx
@@ -4,24 +4,22 @@ description: "Consultez la liste complète des raccourcis clavier de l'éditeur
keywords: ["editor", "keys", "keyboard", "shortcuts"]
---
-Utilisez les raccourcis clavier pour naviguer et modifier plus rapidement dans l'éditeur web. L'éditeur prend en charge les raccourcis courants comme copier, coller, annuler et tout sélectionner, ainsi que les raccourcis listés ci-dessous.
+Utilisez les raccourcis clavier pour naviguer et travailler plus vite dans l'éditeur web. L'éditeur prend en charge les raccourcis courants comme copier, coller, annuler et tout sélectionner, ainsi que les raccourcis listés ci-dessous.
-## Découvrir l'éditeur
+## Mode visuel et mode source
-
-
- Configurez les instructions IA et les valeurs par défaut de publication pour votre deployment.
-
+## Notions de Git
-
- Comprenez les concepts Git qui sous-tendent l'éditeur : branches, commits, pull requests et merges.
-
+
-
-## Sur l'ensemble de l'éditeur
+## Dans tout l'éditeur
-Ces raccourcis fonctionnent quel que soit le mode utilisé.
+Ces raccourcis fonctionnent quel que soit le mode dans lequel vous vous trouvez.
| Commande | macOS | Windows |
| :--- | :--- | :--- |
| **Rechercher des fichiers et du contenu** | Cmd + K | Ctrl + K |
-| **Activer/désactiver l'assistant IA** (en dehors de l'édition de texte) | Cmd + I | Ctrl + I |
+| **Afficher ou masquer l'assistant d'IA** (hors saisie de texte) | Cmd + I | Ctrl + I |
| **Basculer entre le mode visuel et le mode source** | Cmd + Shift + S | Ctrl + Shift + S |
-| **Activer/désactiver la vue diff** | Cmd + Shift + D | Ctrl + Shift + D |
-| **Basculer entre l'arborescence Navigation et Fichiers** | Cmd + Shift + F | Ctrl + Shift + F |
-| **Masquer/afficher la barre latérale** | Cmd + \\ | Ctrl + \\ |
+| **Afficher tous les fichiers** (y compris les dotfiles et les fichiers hors contenu) | Cmd + Shift + . | Ctrl + Shift + . |
@@ -29,7 +27,7 @@ Ces raccourcis fonctionnent quel que soit le mode utilisé.
-Utilisez ces raccourcis lorsque vous modifiez en mode visuel.
+Utilisez ces raccourcis lorsque vous travaillez en mode visuel.
@@ -60,6 +58,8 @@ Utilisez ces raccourcis lorsque vous modifiez en mode visuel.
| **Titre 2** | Cmd + Option + 2 | Ctrl + Alt + 2 |
| **Titre 3** | Cmd + Option + 3 | Ctrl + Alt + 3 |
| **Titre 4** | Cmd + Option + 4 | Ctrl + Alt + 4 |
+| **Titre 5** | Cmd + Option + 5 | Ctrl + Alt + 5 |
+| **Titre 6** | Cmd + Option + 6 | Ctrl + Alt + 6 |
@@ -70,7 +70,7 @@ Utilisez ces raccourcis lorsque vous modifiez en mode visuel.
| Commande | macOS | Windows |
| :--- | :--- | :--- |
| **Liste à puces** | Cmd + Shift + 8 | Ctrl + Shift + 8 |
-| **Bloc de citation** | Cmd + Shift + B | Ctrl + Shift + B |
+| **Citation** | Cmd + Shift + B | Ctrl + Shift + B |
-Le mode source utilise l'éditeur Monaco, qui prend en charge les raccourcis clavier standard de VS Code.
+Le mode source utilise CodeMirror. La plupart des raccourcis courants des éditeurs de code fonctionnent, en plus de ceux ci-dessous.
@@ -81,9 +81,9 @@ Utilisez ces raccourcis lorsque vous modifiez en mode visuel.
| Commande | macOS | Windows |
| :--- | :--- | :--- |
| **Ajouter un lien** au texte sélectionné | Cmd + K | Ctrl + K |
-| **Insérer un saut de ligne** | Cmd + Enter | Ctrl + Enter |
+| **Ajouter un saut de ligne** | Cmd + Enter | Ctrl + Enter |
| **Commenter le texte surligné** | Cmd + Shift + M | Ctrl + Shift + M |
-| **Activer/désactiver le mode suggestion** | Cmd + Shift + E | Ctrl + Shift + E |
+| **Activer ou désactiver le mode suggestion** | Cmd + Shift + E | Ctrl + Shift + E |
| **Menu des composants** | / | / |
| **Sélecteur d'emojis** | : + mot-clé | : + mot-clé |
@@ -93,9 +93,9 @@ Utilisez ces raccourcis lorsque vous modifiez en mode visuel.
-L'éditeur convertit automatiquement certaines séquences de caractères en symboles typographiques au fur et à mesure que vous tapez. Les substitutions sont ignorées à l'intérieur des blocs de code et du code en ligne.
+L'éditeur convertit automatiquement certaines suites de caractères en symboles typographiques pendant que vous écrivez. Il ignore ces substitutions dans les blocs de code et le code en ligne.
-| Saisie | Résultat |
+| Saisissez | Résultat |
| :--- | :--- |
| `->` | → |
| `<-` | ← |
@@ -110,7 +110,7 @@ L'éditeur convertit automatiquement certaines séquences de caractères en symb
@@ -121,7 +121,7 @@ Le mode source utilise l'éditeur Monaco, qui prend en charge les raccourcis cla
| Commande | macOS | Windows |
| :--- | :--- | :--- |
| **Rechercher des fichiers** | Cmd + K | Ctrl + K |
-| **Rechercher** | Cmd + F | Ctrl + F |
+| **Rechercher dans la page** | Cmd + F | Ctrl + F |
@@ -131,11 +131,15 @@ Le mode source utilise l'éditeur Monaco, qui prend en charge les raccourcis cla
| Commande | macOS | Windows |
| :--- | :--- | :--- |
-| **Commenter/décommenter** | Cmd + / | Ctrl + / |
-| **Indenter la ligne** | Tab | Tab |
-| **Désindenter la ligne** | Shift + Tab | Shift + Tab |
-| **Déplacer la ligne vers le haut** | Option + ↑ | Alt + ↑ |
-| **Déplacer la ligne vers le bas** | Option + ↓ | Alt + ↓ |
+| **Gras** (entoure de `**`) | Cmd + B | Ctrl + B |
+| **Italique** (entoure de `_`) | Cmd + I | Ctrl + I |
+| **Commenter ou décommenter** | Cmd + / | Ctrl + / |
+| **Tout replier** | Cmd + Option + Shift + [ | Ctrl + Alt + Shift + [ |
+| **Tout déplier** | Cmd + Option + Shift + ] | Ctrl + Alt + Shift + ] |
+| **Augmenter le retrait de la ligne** | Tab | Tab |
+| **Réduire le retrait de la ligne** | Shift + Tab | Shift + Tab |
+| **Monter la ligne** | Option + ↑ | Alt + ↑ |
+| **Descendre la ligne** | Option + ↓ | Alt + ↓ |
| **Dupliquer la ligne** | Shift + Option + ↓ | Shift + Alt + ↓ |
- L'aperçu en direct fonctionne pour les sites publics et les sites protégés par l'authentification Mintlify. Pour les sites authentifiés, l'éditeur vous connecte automatiquement à l'aperçu.
-
-
-
-
-
-
-
-
- Certains éléments ne peuvent pas être imbriqués dans d'autres. Par exemple, les onglets ne peuvent pas être imbriqués dans des groupes. L'éditeur vous empêche de créer des combinaisons non valides.
-
-
-
-
-Choisissez la bonne structure pour votre contenu :
-
-- **Pages** — Fichiers de documentation individuels. Le bloc de construction fondamental de la navigation.
-- **Groups** — Sections repliables regroupant des pages connexes. Peuvent être imbriquées dans d'autres groupes.
-- **Tabs** — Sections de niveau supérieur avec une navigation horizontale en haut de votre site. Utilisez les onglets lorsque vous avez des domaines distincts comme API Reference et Guides.
-- **Anchors** — Éléments persistants en haut de votre barre latérale. Utiles pour un accès rapide aux ressources externes ou aux sections de niveau supérieur. Peuvent être globaux pour apparaître sur chaque page.
-- **Dropdowns** — Menus déroulants en haut de votre barre latérale. Alternative plus légère aux onglets pour plusieurs sections connexes.
-- **Menus** — Éléments de navigation déroulants au sein d'un onglet pour des liens directs vers des pages spécifiques.
-- **Products** — Un sélecteur pour plusieurs ensembles de documentation produit distincts, chacun avec sa propre structure de navigation.
-- **Versions** — Un sélecteur pour plusieurs versions de documentation simultanées.
-- **Languages** — Un sélecteur pour la documentation en plusieurs langues.
-
-
@@ -144,8 +148,12 @@ Le mode source utilise l'éditeur Monaco, qui prend en charge les raccourcis cla
+{/* vale Mintlify.WordList = NO */}
+
| Commande | macOS | Windows |
| :--- | :--- | :--- |
-| **Ajouter un curseur** | Option + Clic | Alt + Clic |
+| **Ajouter un curseur** | Option + clic | Alt + clic |
| **Ajouter un curseur au-dessus** | Cmd + Option + ↑ | Ctrl + Alt + ↑ |
| **Ajouter un curseur en dessous** | Cmd + Option + ↓ | Ctrl + Alt + ↓ |
+
+{/* vale Mintlify.WordList = YES */}
diff --git a/fr/editor/live-preview.mdx b/fr/editor/live-preview.mdx
deleted file mode 100644
index a411f6d9a..000000000
--- a/fr/editor/live-preview.mdx
+++ /dev/null
@@ -1,69 +0,0 @@
----
-title: "Aperçu en direct"
-description: "Prévisualisez votre site en temps réel pendant l'édition, avec des mises à jour continues qui affichent instantanément les changements de votre site."
-keywords: ["editor", "preview", "live preview"]
----
-
-Prévisualisez votre site pendant que vous le modifiez. Les aperçus en direct affichent les pages exactement telles qu'elles apparaissent une fois publiées. Ils se mettent à jour à mesure que vous modifiez le contenu, la navigation et la configuration.
-
-
-
-## Ouvrir l'aperçu en direct
-
-
-
-Cliquez sur le bouton d'aperçu en direct
-
-
-
-
-
-## Modifier les paramètres du site dans l'aperçu en direct
-
-
-
-Modifiez les paramètres de votre site dans l'aperçu en direct pour voir leur effet sur le contenu affiché.
-
-1. Ouvrez l'aperçu en direct dans l'éditeur.
-2. Cliquez sur **Site settings** dans la barre d'outils de l'aperçu.
-3. Sélectionnez une section de configuration et modifiez les paramètres.
-
-Si vous configurez l'aperçu en direct pour qu'il s'ouvre dans un nouvel onglet, le menu des paramètres du site n'est pas disponible. Désactivez **Open live preview in new tab** dans les [paramètres de l'éditeur](/fr/editor/settings) pour utiliser le menu des paramètres du site.
-
-
-
-## Demander à l'agent dans l'aperçu en direct
-
-
-
-Cliquez sur **Ask agent** dans la barre d'outils de l'aperçu pour ouvrir l'[agent de l'éditeur](/fr/editor/agent) à côté de l'aperçu en direct. Seuls les éditeurs et les administrateurs peuvent utiliser l'agent dans les aperçus en direct.
-
-
-
-## Aperçu en direct vs déploiements de prévisualisation
-
-
-
-| | Aperçu en direct | Déploiement de prévisualisation |
-|---|---|---|
-| **Vitesse** | Immédiat | Nécessite un build |
-| **Accès** | URL locale, avec authentification automatique pour les sites protégés | URL partageable |
-| **Quand l'utiliser** | Pour revoir les modifications pendant l'édition | Pour partager avec votre équipe pour relecture |
-| **Disponibilité** | Tant que l'éditeur reste ouvert | Tant que la branche existe |
-
-Utilisez l'aperçu en direct pour obtenir un retour immédiat pendant l'édition. Lorsque vous devez partager des modifications avec votre équipe ou tester sur un autre appareil, utilisez un [déploiement de prévisualisation](/fr/editor/branching-and-publishing#preview-your-changes).
diff --git a/fr/editor/media.mdx b/fr/editor/media.mdx
deleted file mode 100644
index c99fd6d08..000000000
--- a/fr/editor/media.mdx
+++ /dev/null
@@ -1,100 +0,0 @@
----
-title: "Ajouter des médias"
-description: "Importez, gérez et intégrez des images et autres ressources multimédias dans vos pages de documentation via le gestionnaire de fichiers de l'éditeur."
-keywords: ["editor","media","images","assets"]
----
-
-
- ## Types de fichiers pris en charge
-
-
-* **Images** : PNG, JPG, JPEG, GIF, WebP (max 20 Mo)
-* **Vidéos** : MP4, WebM (max 20 Mo)
-* **Polices** : TrueType (TTF), WOFF, WOFF2
-* **Autres** : PDF, ICO (favicons)
-
-
- ## Ajouter des médias à une page
-
-
-
- ### Glisser-déposer
-
-
-Glissez-déposez des éléments multimédias depuis votre ordinateur ou le gestionnaire de ressources dans une page. En mode visuel, l'image ou la vidéo est insérée directement dans le contenu. En mode Markdown, l'éditeur insère le chemin à l'emplacement de votre curseur. Les images sont enregistrées à la racine de votre dossier `images/`, et les vidéos à la racine de votre dossier `videos/`.
-
-
- ### Commande /
-
-
-Tapez /image pour ouvrir le menu d’images ou /video pour ouvrir le menu de vidéos. Importez un nouveau média ou sélectionnez un fichier existant.
-
-
- ### Intégrer
-
-
-Tapez /embed et collez une URL YouTube, Loom ou Vimeo. L’éditeur détecte le fournisseur et génère automatiquement l’iframe. Dans le menu slash, les recherches `youtube`, `yt`, `loom` et `vimeo` font également apparaître la commande **Embed**.
-
-Pour les autres contenus intégrés, tapez /embed, puis activez **Intégration manuelle** pour écrire du HTML personnalisé.
-
-
- ### Téléverser des fichiers
-
-
-Utilisez l’explorateur de fichiers dans la barre latérale pour téléverser ou rechercher des fichiers. Faites glisser des fichiers et déposez-les dans un dossier pour organiser les ressources multimédias.
-
-
-
-
-
-
-
-
- ## Mettre en forme les images
-
-
-Après avoir inséré une image en mode visuel, survolez-la pour afficher une barre d’outils avec des options de mise en forme.
-
-- **Aperçu clair/sombre** : basculez entre le mode clair et le mode sombre pour voir l’apparence de l’image dans chaque thème.
-- **Alignement** : choisissez un alignement de l’image : gauche, centré, droite ou pleine largeur.
-- **Frame** : entourez l’image d’un composant `` pour ajouter une bordure et un arrière-plan.
-- **Paramètres** : remplacez l’image ou mettez à jour son texte alternatif.
-
-
- ## Gérer les ressources
-
-
-
- ### Organiser à l’aide de dossiers
-
-
-Cliquez sur le bouton **+** dans l’explorateur de fichiers pour créer un nouveau dossier. Faites glisser et déposez des fichiers et des dossiers dans l’arborescence pour les réorganiser.
-
-
- ### Renommer et modifier des ressources
-
-
-Survolez une ressource et cliquez sur le bouton **...** pour renommer le fichier ou mettre à jour son texte alternatif.
-
-
- ### Supprimer des ressources
-
-
-Survolez une ressource, puis cliquez sur le bouton
- ## Bonnes pratiques
-
-
-- **Utilisez des noms explicites** : Nommez clairement vos fichiers, par exemple `api-dashboard-light.png` plutôt que `img1.png`.
-- **Ajoutez un texte alternatif (alt)** : Fournissez un texte alternatif descriptif pour l’accessibilité et le SEO.
-- **Organisez à l’aide de dossiers** : Regroupez les ressources associées, comme les variantes en mode clair et sombre ou pour une fonctionnalité ou une section spécifique.
-- **Utilisez des formats adaptés** : PNG pour les graphiques avec transparence, JPG pour les photos, SVG pour les icônes et les logos (vous ne pouvez pas téléverser de fichiers SVG via l'éditeur, mais vous pouvez les ajouter à votre référentiel via Git).
\ No newline at end of file
diff --git a/fr/editor/navigation.mdx b/fr/editor/navigation.mdx
deleted file mode 100644
index aaf1fd07f..000000000
--- a/fr/editor/navigation.mdx
+++ /dev/null
@@ -1,49 +0,0 @@
----
-title: "Organiser la navigation"
-description: "Réordonnez les pages, ajoutez des groupes et gérez la structure de la barre latérale par glisser-déposer dans l'éditeur web Mintlify, sans docs.json."
-keywords: ["editor", "navigation", "sidebar", "structure"]
----
-
-Utilisez la barre latérale de navigation pour organiser votre documentation. Les modifications que vous apportez dans l'éditeur sont synchronisées avec votre référentiel lorsque vous publiez — vous n'avez pas besoin de modifier `docs.json` manuellement.
-
-
-
-Cliquez sur **Add new** au bas de l'arborescence de navigation pour ajouter un nouvel élément au niveau racine. Pour ajouter un élément imbriqué dans un autre, cliquez sur le bouton
- ## Configurer les éléments
-
-
-Survolez n'importe quel élément de navigation et cliquez sur l'icône d'engrenage pour définir :
-
-- **Title** : L'étiquette affichée dans la barre latérale.
-- **Icon** : Un repère visuel à côté de l'étiquette.
-- **Tag** : Un badge comme « NEW » ou « BETA » pour mettre en évidence l'élément.
diff --git a/fr/editor/pages.mdx b/fr/editor/pages.mdx
index cecfa47dd..b8c57fd68 100644
--- a/fr/editor/pages.mdx
+++ b/fr/editor/pages.mdx
@@ -1,246 +1,94 @@
---
title: "Créer et modifier des pages"
-description: "Créez des pages, modifiez le contenu, téléversez images et vidéos et gérez les fichiers dans l'éditeur web Mintlify en texte enrichi."
-keywords: ["editor", "content", "pages", "files", "create", "edit", "version history", "media", "images", "video", "task lists", "private pages"]
+sidebarTitle: "Modifier le contenu"
+description: "Créez des pages, modifiez du contenu, ajoutez des médias, organisez votre navigation et restaurez des versions antérieures d'une page dans l'éditeur."
+keywords: ["editor", "content", "pages", "navigation", "version history", "media", "images", "private pages"]
---
-
+
-## Parcourir les fichiers
+## Home et Publishing
-Le panneau de gauche propose deux vues : **Navigation** et **Files**.
+L'espace de travail de l'éditeur est divisé en deux onglets : **Home** et **Publishing**.
-**Navigation** affiche la structure de votre barre latérale telle que les visiteurs la voient. Cliquez sur une page pour l'ouvrir.
+**Home** est votre espace de travail. Il affiche les fichiers de contenu de votre dépôt, y compris vos pages privées, qu'elles apparaissent ou non sur votre site publié.
-**Files** affiche l'arborescence complète des fichiers de votre référentiel, y compris les fichiers qui ne figurent pas dans votre navigation. Cliquez sur n'importe quel fichier pour l'ouvrir.
+**Publishing** est votre site publié. Il affiche la navigation que voient vos visiteurs, ainsi que les paramètres de votre site.
-Pour basculer entre les vues, cliquez sur l'icône de dossier
+
-## Gérer les fichiers et les dossiers
+## Créer une page
-Utilisez la vue Files pour organiser votre contenu :
+Pour ajouter une page à votre navigation, cliquez sur le bouton
-
-## Créer de nouvelles pages
-
-
-
-
+
-### Ajouter une page à la navigation
+## Ajouter des médias
-1. Cliquez sur le bouton plus
-
-### Créer une page non listée
-
-
+Saisissez /image ou /video pour téléverser un fichier ou en choisir un déjà présent dans votre dépôt. Vous pouvez aussi faire glisser des fichiers depuis votre ordinateur sur la page. Pour réutiliser un média, faites glisser une image ou une vidéo depuis l'arborescence de navigation sur une page.
-Les pages non listées existent dans votre référentiel mais n'apparaissent pas dans la navigation. Elles sont utiles pour du contenu en brouillon, des snippets réutilisables ou des pages que vous prévoyez d'ajouter ultérieurement à la navigation.
+- Les fichiers téléversés sont enregistrés dans vos dossiers `images/` et `videos/` et sont inclus dans le commit de votre prochaine publication.
+- Les formats pris en charge sont PNG, JPG, JPEG, GIF, WebP, SVG, MP4 et WebM.
+- Pour afficher des images différentes en mode clair et en mode sombre, survolez une image insérée et utilisez **Light/dark variants**.
+- Saisissez /embed et collez une URL YouTube, Loom ou Vimeo pour générer l'iframe. Pour tout autre cas, activez **Manual embed** afin d'écrire du HTML personnalisé.
-Faites un clic droit sur un dossier dans la vue Files et sélectionnez **New file**. Saisissez un nom de fichier ; l'éditeur crée la page sans l'ajouter à la navigation. Vous pourrez l'ajouter ultérieurement à la navigation depuis l'onglet **Navigation**.
+Pour la mise en forme des images et l'utilisation du composant Frame, consultez [Images et intégrations](/fr/create/image-embeds).
-
+
-Basculez entre le mode visuel et le mode source à l'aide du bouton de bascule de mode dans la barre d'outils sous la barre supérieure. Cliquez sur l'icône en forme d'œil
+ Certains éléments ne peuvent pas être imbriqués dans d'autres. Par exemple, les tabs ne peuvent pas être imbriqués dans des groups. L'éditeur empêche les combinaisons non valides.
+
-Vous pouvez également ouvrir un diff depuis le menu de publication. Cliquez sur **Publish** puis sur n'importe quel fichier modifié dans la liste.
+Pour modifier le titre, le slug, la description ou le layout d'une page, ouvrez ses paramètres depuis l'arborescence de navigation. Consultez [Pages](/fr/organize/pages) pour plus d'informations sur chaque paramètre.
-
-
+L'éditeur enregistre une nouvelle entrée dès que le contenu diffère de la dernière version enregistrée. L'historique des versions est limité à la branch. Seul l'historique de la branch actuelle est disponible.
-
-
-### Vue diff
+Faites glisser des éléments dans la vue Navigation pour les réordonner ou les imbriquer. L'éditeur écrit vos modifications dans `docs.json` lorsque vous publiez.
-
+- **Groups** : Sections repliables qui regroupent des pages liées. Peuvent être imbriquées dans d'autres groups.
+- **Tabs** : Sections de premier niveau avec une navigation horizontale. Utilisez-les pour des espaces distincts, comme une référence d'API et des guides.
+- **Anchors** : Éléments persistants en haut de votre barre latérale. Utiles pour des ressources externes. Peuvent être globaux et apparaître sur toutes les pages.
+- **Dropdowns** : Menus déroulants en haut de votre barre latérale. Une alternative plus légère aux tabs.
+- **Menus** : Éléments déroulants au sein d'un tab qui renvoient directement vers des pages précises.
+- **Products** : Un sélecteur pour plusieurs ensembles de documentation produit, chacun avec sa propre navigation.
+- **Versions** : Un sélecteur pour plusieurs versions simultanées de la documentation.
+- **Languages** : Un sélecteur pour de la documentation en plusieurs langues.
-Pour comparer votre page actuelle à la dernière version publiée, cliquez sur le bouton
-### Historique des versions
-
-
-
-Utilisez l'historique des versions pour consulter les versions enregistrées de la page que vous modifiez.
-
-Mint enregistre une nouvelle entrée lorsque l'éditeur enregistre un contenu différent de la dernière version enregistrée. L'enregistrement d'un contenu inchangé ne crée pas d'entrée en double. Une page enregistrée peut également être vide.
-
-L'historique des versions regroupe les entrées par date. Chaque entrée indique l'auteur et l'heure d'enregistrement. Mint marque l'entrée la plus récente comme **Current**.
-
-Pour ouvrir l'historique des versions :
-
-1. Ouvrez une page de documentation dans l'éditeur. L'historique des versions n'est pas disponible pour `docs.json`.
-1. Cliquez sur **More options** dans l'angle supérieur droit.
-1. Sélectionnez **Version history**.
-
-Lorsque l'historique des versions est disponible pour la page, vous pouvez également cliquer sur l'horodatage **Edited** dans l'en-tête de l'éditeur pour ouvrir le panneau. Pour les pages non prises en charge, l'horodatage reste non interactif.
-
-Le panneau affiche les versions de la page actuelle. L'historique des pages publiques inclut uniquement la branche actuelle. L'historique des pages privées inclut les entrées de toutes les branches. Cliquez sur **Show more versions** pour charger les entrées plus anciennes.
-
-Les viewers peuvent consulter et comparer les versions enregistrées des pages privées. Les editors et les managers peuvent les restaurer. Les versions antérieures incluent l'action **Restore** lorsque vous avez l'autorisation de modifier la page. Cliquez sur **Restore**, puis confirmez pour remplacer le contenu actuel de la page par cette version enregistrée. Cette action écrase les modifications non enregistrées.
-
-Restore applique l'instantané sélectionné à la page actuelle. Pour les pages publiques, il restaure la page sur la branche actuelle. Pour les pages privées, il met à jour le contenu privé partagé.
-
-Pour comparer une version enregistrée antérieure à la page actuelle, cliquez sur sa ligne. L'éditeur ouvre la vue diff avec la version enregistrée comme référence et le contenu actuel de la page comme comparaison. La ligne affiche **Viewing** lorsqu'elle est active. Cliquez à nouveau sur la ligne active pour quitter la comparaison et revenir à l'édition.
-
-Restore n'est pas disponible sur les branches de déploiement bloquées ni sur la version **Current**.
-
-
-
-### Actions sur les blocs
+## Historique des versions
-En mode visuel, survolez n'importe quel bloc pour faire apparaître une poignée de glissement à gauche. Cliquez sur la poignée pour ouvrir un menu contextuel avec les actions disponibles pour ce bloc :
+L'historique des versions vous permet de consulter et de restaurer des versions enregistrées antérieures d'une page. Il n'est pas disponible pour `docs.json`.
-- **Turn into** : Convertit le bloc en un autre type : texte, titres, bloc de citation ou liste.
-- **Duplicate** : Insère une copie du bloc immédiatement à sa suite.
-- **Delete** : Supprime le bloc.
+Les viewers peuvent consulter et comparer les versions enregistrées des pages privées. Les editors et les admins peuvent les restaurer.
-
-
-
-
+L'éditeur enregistre une nouvelle entrée dès que le contenu diffère de la dernière version enregistrée. L'historique des versions est limité à la branch. Seul l'historique de la branch actuelle est disponible.
-
+Pour consulter l'historique des versions, cliquez sur
+
-En mode visuel, l'éditeur affiche une minimap sur le côté droit de la page qui reflète la structure des titres de votre document. Survolez la minimap pour la développer en une table des matières complète. Cliquez sur n'importe quel titre pour faire défiler jusqu'à cette section.
-
-
- Vous ne pouvez pas replacer un contenu de l'espace de travail dans la section **Private**.
+ Vous ne pouvez pas ramener du contenu du workspace vers la section **Private**. Rendre publique une page privée est un changement irréversible.
-
-
- Lorsque vous créez une pull request depuis l'éditeur, l'agent Mintlify génère un titre et une description en fonction de vos modifications. Vous pouvez modifier le titre et la description générés avant de créer la pull request.
-
-
-**Publier directement** : Si votre référentiel n'a aucune règle de protection de branche, vos modifications sont fusionnées dans la branche de déploiement et déployées immédiatement lorsque vous publiez.
+
+ Si vous ne voyez ni sélecteur de branch ni bouton **Publish**, la [publication automatique](#auto-publish) est activée sur votre deployment et vos modifications sont mises en ligne automatiquement.
+
-| Type de branche | Protection de la branche | Workflow de publication |
-|-------------|-------------------|------------------------------|
-| Branche de déploiement | Aucune | Effectue des commits et déploie les modifications |
-| Branche de déploiement | Pull requests requises | Crée une pull request (demande de fusion) |
-| Branche de fonctionnalité | Aucune | Fusionne les modifications dans la branche de déploiement et les déploie |
-| Branche de fonctionnalité | Pull requests requises | Crée une pull request (demande de fusion) |
+
-
-### Options des blocs de code
+## Pages privées
-Lors de l'édition d'un bloc de code en mode visuel, vous pouvez :
-
-- **Surligner ou mettre en focus des lignes** : Sélectionnez du texte dans le bloc de code, puis utilisez la barre d'outils qui apparaît pour marquer les lignes comme surlignées ou en focus. Le surlignage met visuellement en valeur les lignes. La mise en focus atténue tout le reste.
-- **Marquer des lignes de diff** : Sélectionnez des lignes et utilisez la barre d'outils pour les marquer comme ajouts (`+`) ou suppressions (`-`).
-- **Wrap** : Activez le retour à la ligne dans les paramètres du bloc de code.
-- **Expandable** : Rendez le bloc de code repliable pour que les lecteurs puissent le développer à la demande.
-
-
-
-## Gérer les pages
-
-
-
-- **Déplacer** : Faites glisser-déposer les pages pour les réorganiser dans la navigation.
-- **Renommer** : Faites un clic droit sur une page et sélectionnez **Rename**.
-- **Dupliquer** : Faites un clic droit sur une page et sélectionnez **Duplicate**.
-- **Supprimer** : Faites un clic droit sur une page et sélectionnez **Delete**. L'éditeur retire automatiquement la page de la navigation.
-
-### Déplacer les pages privées vers l'espace de travail
-
-Pour transformer une page ou un dossier privé en contenu d'espace de travail, faites glisser le contenu privé depuis la section **Private** vers un dossier de votre espace de travail. Vous pouvez aussi faire un clic droit sur le contenu privé et sélectionner **Move to workspace**.
-
-Quand vous déplacez un dossier privé, toutes les pages du dossier passent dans votre espace de travail. Tout contenu que vous déplacez vers l'espace de travail devient immédiatement accessible aux collaborateurs de l'espace de travail, mais il n'est pas ajouté à la navigation de votre site.
+Faire glisser une page ou un dossier privé dans votre workspace le met immédiatement à la disposition de vos collaborateurs, sans pour autant l'ajouter à la navigation de votre site.
-
-### Pages supprimées via Git
-
-
-
-Si un coéquipier supprime une page via Git pendant que vous l'avez ouverte, l'éditeur passe en mode lecture seule et affiche une bannière. L'éditeur conserve votre contenu afin que vous puissiez le copier avant de quitter.
-
-
-
-## Configurer les pages
-
-
-
-Survolez une page et cliquez sur l'icône d'engrenage, ou faites un clic droit et sélectionnez **Settings**, pour configurer :
-
-- **Title**, **Slug** et **Sidebar title** : Contrôlez la façon dont la page apparaît dans la navigation et son URL.
-- **Description** et **Keywords** : Améliorent la recherche et le SEO.
-- **Layout** : Choisissez entre standard, wide, centered ou custom.
-
-Pour plus de détails sur chaque paramètre, consultez [Pages](/fr/organize/pages).
-
-
-
-## Ajouter des médias
-
-
-
-
-
-### Images et vidéos
-
-
-
-Tapez /image pour téléverser une nouvelle image ou en sélectionner une existante depuis votre référentiel. Tapez /video pour téléverser ou sélectionner une vidéo.
-
-Vous pouvez également faire glisser-déposer des fichiers de votre ordinateur directement sur une page. En mode visuel, le fichier s'insère inline. En mode source, l'éditeur insère le chemin du fichier à l'emplacement du curseur. Les images sont enregistrées dans votre dossier `images/` et les vidéos dans `videos/`.
-
-Pour réutiliser un média déjà présent dans votre projet, faites glisser un fichier image ou vidéo depuis l'arborescence de navigation sur la page. L'éditeur intègre l'élément inline.
-
-
-
-### Variantes d'images claires et sombres
-
-
-
-Après avoir inséré une image en mode visuel, survolez-la pour faire apparaître la barre d'outils de l'image. Utilisez **Light/dark variants** pour téléverser des images distinctes pour les modes clair et sombre.
-
-
-
-### Intégrer des médias externes
-
-
-
-Tapez /embed et collez une URL YouTube, Loom ou Vimeo. L'éditeur détecte le fournisseur et génère l'iframe. La recherche dans le menu slash de `youtube`, `yt`, `loom` ou `vimeo` fait également apparaître la commande **Embed**.
-
-Pour les autres intégrations, tapez /embed et activez **Manual embed** pour écrire du HTML personnalisé.
-
-Pour en savoir plus sur la mise en forme des images et l'utilisation du composant Frame, consultez [Images et intégrations](/fr/create/image-embeds).
diff --git a/fr/editor/publish.mdx b/fr/editor/publish.mdx
index fa0d36e41..a6ef574de 100644
--- a/fr/editor/publish.mdx
+++ b/fr/editor/publish.mdx
@@ -1,108 +1,96 @@
---
-title: "Publier les modifications dans l’éditeur web"
+title: "Publier des modifications"
sidebarTitle: "Publier"
-description: "Enregistrez votre travail, gérez branches et pull requests, et publiez les modifications depuis l'éditeur web vers votre site en production."
-keywords: ["éditeur", "publier", "modifications", "branches", "pull requests"]
+description: "Publiez des modifications depuis l'éditeur vers votre site publié. Les branches et les règles de protection déterminent ce qui se passe lorsque vous publiez."
+keywords: ["publish", "branch", "git", "commit", "conflicts", "deploy", "pull request"]
---
-
- ## Workflows de publication
-
-
-L'éditeur prend en charge deux workflows pour publier des mises à jour de la documentation. Le workflow que vous utilisez dépend des règles de protection des branches de votre référentiel et de la branche sur laquelle vous travaillez.
-
-**Créer des pull requests** : Si votre référentiel comporte une règle de protection de branche qui impose des pull requests avant que les modifications puissent être fusionnées dans votre branche de déploiement, l'éditeur crée une pull request (demande de fusion) lorsque vous publiez des modifications.
+Vos modifications sont enregistrées automatiquement pendant que vous travaillez, mais elles n'atteignent votre site publié que lorsque vous les publiez. Ce qui se passe alors dépend de la branch sur laquelle vous travaillez et du fait que cette branch exige ou non des pull requests.
-
-
- Configurez des règles de protection des branches dans votre fournisseur Git pour exiger des pull requests. Voir [À propos des branches protégées](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches) dans la documentation GitHub ou [Branches protégées](https://docs.gitlab.com/user/project/repository/branches/protected/) dans la documentation GitLab.
-
+## Modifications en attente
-
-
-
+Deployment branch | Aucune | **Publish** directement vers votre site publié |
+| Deployment branch | Pull requests requises | **Create branch** pour déplacer les modifications vers une nouvelle branch |
+| Feature branch | Aucune | **Save in branch**, **Create pull request** |
+| Feature branch | Pull requests requises | **Save in branch**, **Create pull request** |
-
+ Votre site est mis à jour une fois que Mintlify a compilé et déployé vos modifications. Cela prend généralement de 30 secondes à quelques minutes. Consultez l'état du déploiement sur votre [dashboard](https://app.mintlify.com).
+
-Cliquez sur un fichier dans la liste pour ouvrir une vue de diff montrant les modifications entre la branche et le contenu publié. Les fichiers de documentation s’ouvrent dans un diff visuel, et les autres types de fichiers s’ouvrent dans un diff source. Utilisez cette fonctionnalité pour examiner l’ensemble des modifications d’une branche avant de publier.
+
- ## Enregistrer les modifications
-Pendant que vous modifiez le contenu, l’éditeur suit vos changements.
+L'éditeur considère les éléments suivants comme des modifications en attente :
-- Nouveaux fichiers ou fichiers supprimés.
-- Modifications de contenu dans les pages.
-- Changements dans la structure de navigation.
-- Téléversement et organisation des médias.
-- Mises à jour de la configuration.
+- Les modifications de contenu dans les pages
+- Les pages ajoutées ou supprimées
+- Les changements de structure de navigation
+- Les médias téléversés
+- Les mises à jour de configuration
-Lorsque vous travaillez sur votre branche de déploiement, les modifications sont enregistrées automatiquement.
+S'il n'y a aucune modification en attente, l'éditeur désactive les actions de publication et d'enregistrement.
-
-
-
-
+
-Lorsque vous travaillez sur une branche de fonctionnalité, enregistrez les modifications dans la branche.
+## Ce qui se passe lorsque vous publiez
-
-
-
-
+
-Pour annuler des modifications, cliquez sur **Annuler les modifications** à côté d’un nom de fichier dans le menu déroulant des fichiers modifiés.
+| Type de branch | Protection de branch | Actions disponibles |
+| --- | --- | --- |
+|
-
-
+
- ## Examiner les modifications de la branche
-
+- **Publish** : Commit et déploie vos modifications vers votre site publié immédiatement.
+- **Save in branch** : Commit vos modifications sur la feature branch sans fusionner dans votre deployment branch.
+- **Create branch** : Déplace vos modifications en attente vers une nouvelle feature branch lorsque vous êtes sur une deployment branch protégée.
+- **Create pull request** : Ouvre une pull request vers votre deployment branch.
+
+Une seule publication peut avoir lieu à la fois par branch. Si un collègue publie sur la même branch, attendez la fin de sa publication avant de réessayer.
-Lorsque vous travaillez sur une branche de fonctionnalité, le panneau de publication affiche toutes les modifications de fichiers entre votre branche et la branche de déploiement sous **Saved in branch**. Cela inclut les modifications enregistrées par vous et par tout collègue travaillant sur la même branche.
+
-Les fichiers qui ne peuvent pas afficher de diff, comme les images ou les fichiers supprimés, apparaissent dans la liste mais ne sont pas cliquables.
+## Quand utiliser une branch
-
- Votre site de documentation en production est mis à jour après que Mintlify a compilé et déployé vos modifications publiées. Cela prend généralement entre 30 secondes et quelques minutes. Vérifiez l’état du déploiement de vos modifications sur votre [dashboard](https://dashboard.mintlify.com).
+ Créer une branch ou en changer alors que vous avez des modifications non publiées vous invite à les emporter avec vous ou à les laisser. Les modifications que vous laissez restent sur la branch d'origine.
-## Résoudre les conflits
+
- ## Publier vos modifications
-Cliquez sur **Publier** dans la barre d’outils. Selon votre workflow, vos modifications sont déployées immédiatement ou créent une pull request à fusionner dans votre fournisseur Git. Si vous êtes sur une branche de fonctionnalité, enregistrez vos modifications avant de publier.
+Travaillez directement sur votre deployment branch si vous n'utilisez pas de workflow basé sur Git. Créez une branch si chaque modification passe par une révision avant d'atteindre votre site publié.
-S’il n’y a aucune modification en attente ou si une pull request est déjà ouverte pour la branche actuelle, le bouton **Publier** n’est pas cliquable.
+Pour créer une branch, cliquez sur le nom de la branch dans la barre d'outils de l'éditeur, sélectionnez **Create new branch**, saisissez un nom, puis cliquez sur **Create branch**.
-Les conflits se produisent lorsque votre branche et la branche de déploiement comportent des modifications incompatibles dans les mêmes fichiers.
+## Résoudre les conflits
-
- ### Quelles sont les causes des conflits ?
-Les conflits surviennent lorsque vous essayez de fusionner des branches contenant des modifications incompatibles apportées aux mêmes fichiers.
+Les conflits surviennent lorsque votre branch et la deployment branch comportent des modifications incompatibles sur les mêmes fichiers. Par exemple, lorsque vous et un collègue modifiez les mêmes lignes ou déplacez un fichier vers des emplacements différents.
-* Vous et un autre membre de l'équipe modifiez les mêmes lignes dans un fichier sur des branches différentes.
-* Vous déplacez, renommez ou supprimez des fichiers dans une branche, mais les modifiez différemment dans une autre.
+Lorsque quelqu'un pousse des modifications vers votre dépôt en dehors de l'éditeur, l'éditeur applique automatiquement celles qui ne se chevauchent pas. Si une modification distante et la vôtre portent sur la même partie d'une page, l'éditeur met le conflit en évidence.
+
+L'éditeur affiche un avertissement lorsque des conflits empêchent la publication. Suivez les instructions pour choisir la version à conserver pour chaque section en conflit.
+
+
+
+## Signature des commits
-
- ### Résoudre les conflits
-L’éditeur affiche des avertissements lorsque des conflits empêchent d’effectuer des opérations comme la publication ou le changement de branche. Pour résoudre les conflits, suivez les instructions dans l’éditeur pour choisir les modifications à conserver.
+Signez vos commits avec votre compte GitHub en l'autorisant dans les [paramètres de votre compte](https://app.mintlify.com/settings/account). Sans cette autorisation, la GitHub App de Mintlify signe les commits effectués dans l'éditeur.
+
+
+
+## Publication automatique
-
+ L'aperçu en direct fonctionne pour les sites publics et pour les sites protégés par l'authentification Mintlify.
+
+
+
+
+
+
+Les URLs de prévisualisation sont publiques par défaut. Pour en restreindre l'accès aux membres de votre organisation Mintlify, activez l'authentification des aperçus sur la page [Add-ons](https://app.mintlify.com/products/addons) de votre dashboard.
+
+
+ Configurez des règles de protection de branch chez votre fournisseur Git pour exiger des pull requests. Consultez [About protected branches](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches) dans l'aide GitHub ou [Protected branches](https://docs.gitlab.com/user/project/repository/branches/protected/) dans l'aide GitLab.
+
+
+
- ## Signature des commits
-Signez vos commits avec votre compte GitHub en l’autorisant dans vos [paramètres de compte](https://dashboard.mintlify.com/settings/account). Sans cette autorisation, la GitHub App de Mintlify signe les commits effectués dans l’éditeur web.
+Si la [publication automatique](/fr/editor/settings#main-branch-autocommits) est activée sur votre deployment, l'éditeur commit sur votre deployment branch peu après que vous arrêtez d'écrire. Le sélecteur de branch et le bouton **Publish** sont masqués. Il n'y a ni état en attente ni étape de révision.
-Attribuer les commits à votre compte permet de conserver un historique précis des personnes ayant modifié votre documentation.
\ No newline at end of file
+Les modifications sur les feature branches créées depuis l'éditeur sont commitées automatiquement dans les deux cas, mais elles ne sont jamais publiées tant que vous ne les fusionnez pas dans votre deployment branch.
diff --git a/fr/editor/review.mdx b/fr/editor/review.mdx
new file mode 100644
index 000000000..f5ec6f12a
--- /dev/null
+++ b/fr/editor/review.mdx
@@ -0,0 +1,131 @@
+---
+title: "Réviser les modifications"
+sidebarTitle: "Réviser"
+description: "Prévisualisez vos modifications avant leur mise en ligne, partagez-les avec votre équipe, puis approuvez et fusionnez les pull requests depuis l'éditeur."
+keywords: ["review", "preview", "live preview", "pull request", "approve", "merge", "diff"]
+---
+
+Prévisualisez vos modifications avant qu'elles n'atteignent votre site publié, puis révisez et fusionnez la pull request sans quitter l'éditeur.
+
+
+
+## Aperçu en direct
+
+
+
+L'aperçu en direct affiche votre site pendant que vous le modifiez, sans étape de compilation. Cliquez sur le bouton
+
+## Déploiements de prévisualisation
+
+
+
+Lorsque vous ouvrez une pull request depuis une feature branch, Mintlify compile un déploiement de prévisualisation : une URL temporaire où vos modifications s'affichent exactement comme elles le seront une fois publiées. L'aperçu est recompilé chaque fois que vous enregistrez de nouvelles modifications sur la branch.
+
+Pour trouver et partager l'URL, cliquez sur **Publish** dans la barre d'outils. Le format de l'URL est `organization-branch-name.mintlify.site`.
+
+
+
+
+
+
+Les URLs de prévisualisation sont publiques par défaut. Pour en restreindre l'accès aux membres de votre organisation Mintlify, activez l'authentification des aperçus sur la page [Add-ons](https://app.mintlify.com/products/addons) de votre dashboard.
+
+
+
+## Quel aperçu utiliser
+
+
+
+| | Aperçu en direct | Déploiement de prévisualisation |
+|---|---|---|
+| **Rapidité** | Instantané | Nécessite une compilation |
+| **Accès** | URL locale | URL partageable |
+| **À utiliser quand** | Vous révisez des modifications en cours d'édition | Vous partagez avec votre équipe pour révision |
+| **Disponibilité** | Tant que l'éditeur est ouvert | Tant que la branch existe |
+
+
+
+Pour diriger un collègue vers une page précise d'une branch, copiez l'URL depuis la barre d'adresse de votre navigateur. Toute personne ayant accès à votre organisation Mintlify peut l'ouvrir dans sa propre session de l'éditeur.
+
+```text
+https://app.mintlify.com/{org}/{project}/editor/{branch}/~/{filepath}
+```
+
+Par exemple : `https://app.mintlify.com/acme/docs/editor/main/~/guides/quickstart.mdx`
+
+
+
+## Réviser et fusionner les pull requests
+
+
+
+Lorsqu'une pull request est ouverte pour la branch actuelle, le menu de publication affiche un panneau de révision avec :
+
+- Le titre et la description de la pull request
+- Les branches source et cible
+- Le nombre de fichiers modifiés
+- L'exigence d'approbation sur la deployment branch
+- L'état actuel de la révision
+
+Une fois qu'un relecteur a approuvé, cliquez sur **Merge and publish** pour fusionner et déployer depuis l'éditeur. L'éditeur vous ramène ensuite sur votre deployment branch.
+
+
+
+### Approuver depuis l'éditeur
+
+
+
+Pour les dépôts GitHub, les relecteurs peuvent approuver les pull requests ouvertes sans quitter l'éditeur. Un bouton **Approve pull request** apparaît dans le panneau de révision si votre compte a le droit de la relire. L'état passe à **Approved** et **Merge and publish** devient disponible.
+
+Si vous utilisez GitLab ou Bitbucket, ouvrez la pull request chez votre fournisseur Git pour l'approuver.
+
+
+
+### Comparer les modifications avant de fusionner
+
+
+
+Cliquez sur n'importe quel fichier modifié dans le menu de publication pour l'ouvrir en vue diff face à la version publiée. Le mode visuel affiche un diff visuel et le mode source affiche un diff textuel. Les fichiers qui ne peuvent pas afficher de diff, comme les images ou les fichiers supprimés, figurent dans la liste mais ne sont pas cliquables.
+
+Les [pages masquées](/fr/organize/hidden-pages) qui apparaissent dans le diff de la branch peuvent être ouvertes depuis le menu de publication, même si elles ne figurent pas dans la navigation de votre site.
+
+
+
+### Titres et descriptions des pull requests
+
+
+
+Si votre organisation exige des pull requests, vous pouvez saisir un titre et une description au moment de publier. Si vous laissez l'un des deux vide, l'éditeur en génère un listant les fichiers que vous avez créés, mis à jour, déplacés ou supprimés. Pour contrôler leur rédaction, définissez des [instructions de PR](/fr/editor/settings#pr-instructions).
+
+Si votre branch comporte des fils de commentaires ouverts, Mintlify ajoute leur résumé à la description de la pull request. Consultez [Collaborer](/fr/editor/collaborate#comments).
+
+
+
+## Réviser une exécution d'automatisation
+
+
+
+Lorsqu'une [automatisation](/fr/automations) ouvre une pull request, vous pouvez ouvrir l'éditeur sur la branch de l'automatisation :
+
+- Depuis la page **Automation Runs** de votre dashboard, cliquez sur **Open in editor** sur une exécution terminée.
+- Depuis une notification Slack, cliquez sur le lien **View changes**.
+
+Ces deux points d'entrée ouvrent l'éditeur sur la branch de l'automatisation, avec les pages modifiées présélectionnées dans le menu de publication, ce qui vous permet de réviser le diff et de fusionner ou de demander des modifications sans quitter l'éditeur. L'[agent](/fr/editor/agent#continue-an-automation-run) s'ouvre à côté avec le contexte de ce qu'a fait l'automatisation.
diff --git a/fr/editor/settings.mdx b/fr/editor/settings.mdx
index c02a1a051..aa744d600 100644
--- a/fr/editor/settings.mdx
+++ b/fr/editor/settings.mdx
@@ -1,112 +1,39 @@
---
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."
-keywords: ["editor", "settings", "ai", "instructions", "publishing", "pull request", "merge", "lock branch"]
+sidebarTitle: "Paramètres"
+description: "Configurez l'apparence de l'éditeur, les instructions d'IA et les valeurs par défaut de publication pour contrôler l'aspect de l'éditeur et la façon dont il commit et fusionne les modifications."
+keywords: ["editor", "settings", "ai", "instructions", "publishing", "pull request", "merge", "appearance", "preferences"]
---
-L'éditeur web comporte deux niveaux de paramètres :
+La [page de paramètres](https://app.mintlify.com/settings/deployment/editor) de l'éditeur contrôle l'apparence, le comportement de publication et le comportement de l'agent.
-- **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.
+- **Appearance** : Préférences personnelles sur l'aspect et le comportement de l'éditeur. Elles ne s'appliquent qu'à vous.
+- **Publishing** : Valeurs par défaut, à l'échelle du deployment, sur la façon dont l'éditeur commit les modifications et ouvre les pull requests. Elles s'appliquent à toutes les personnes qui publient.
+- **Chat** : Instructions persistantes pour l'agent d'IA de l'éditeur.
+- **Danger zone** : Actions irréversibles.
-Vous pouvez configurer les deux depuis le panneau des paramètres. Pour l'ouvrir, cliquez sur l'icône de paramètres
-` pour les encarts.
-
-Gardez les instructions courtes et précises. L'IA les suit à chaque requête, donc des règles vagues ou contradictoires dégradent les résultats.
-
- or components.
-- Do not add introductory filler like "In this guide" or "Let's explore".
-```
-
-Laissez le champ vide pour supprimer vos instructions.
-
-
- Activer le verrouillage abandonne toutes les modifications non publiées de l'éditeur sur la branche de déploiement et force la resynchronisation de l'éditeur avec votre dépôt Git. Publiez les modifications en attente ou déplacez-les vers une branche de brouillon avant d'activer le verrouillage.
-
-
-Tant que le verrouillage est actif, les push Git entrants vers la branche de déploiement écrasent l'état en direct de l'éditeur, de sorte que toute modification en cours sur cette branche est remplacée par le dernier commit.
-
-Utilisez ce paramètre lorsque votre équipe souhaite que Git reste la source de vérité pour le site en direct, et que toutes les modifications faites dans l'éditeur passent par des pull requests depuis des branches de fonctionnalité.
+Les préférences d'apparence sont liées à votre compte utilisateur et prennent effet dès que vous les activez.
-Pour modifier pendant que la branche de déploiement est verrouillée, utilisez le sélecteur de branche dans la barre supérieure pour créer une branche de brouillon ou basculer vers celle-ci. Publiez ces modifications en ouvrant une pull request depuis votre branche de brouillon, comme pour toute autre branche de l'éditeur.
+- **Fit editor to full width** : Étend la zone d'édition d'un bord à l'autre au lieu d'utiliser la colonne de largeur fixe par défaut.
+- **Show breadcrumbs** : Affiche l'emplacement de la page dans la navigation du site au-dessus de la zone d'édition.
+- **Open live preview in new tab** : Ouvre la page rendue dans un nouvel onglet du navigateur lors de la prévisualisation. Laissez cette option désactivée pour modifier les paramètres du site depuis l'[aperçu en direct](/fr/editor/review#live-preview).
+- **Show all files** : Affiche tous les fichiers dans la barre latérale, y compris les dotfiles, le code, les PDF et les autres fichiers que l'arborescence de navigation masque par défaut.
-
-
-## Instructions d'IA
-
-
-
-Les instructions d'IA sont des consignes persistantes que l'éditeur envoie à l'IA avec votre requête. Utilisez-les pour formuler des règles de style et de ton que vous ne voulez pas répéter à chaque fois, comme la voix, la terminologie ou les conventions de mise en forme.
-
-Vos instructions s'appliquent à :
-
-- Les actions **Edit with AI** sur une sélection, comme réécrire, développer ou corriger.
-- Les **sessions de l'agent** lancées depuis l'éditeur.
-
-Chaque membre de l'équipe gère ses propres instructions, liées à son compte utilisateur.
-
-
-
-### Quand utiliser les instructions d'IA
-
-
-
-Ajoutez des instructions d'IA lorsque vous vous surprenez à répéter les mêmes consignes dans vos prompts, par exemple :
-
-- Imposer la deuxième personne ou des titres en majuscule initiale uniquement.
-- Privilégier des noms de produit ou une terminologie spécifiques.
-- Bannir le langage marketing ou les phrases de remplissage.
-- Exiger certains composants, comme toujours utiliser `
-
-### Configurer les instructions d'IA
-
-
-
-1. Cliquez sur l'icône de paramètres
-
-## Paramètres de publication
-
-
-
-Vous configurez les paramètres de publication par déploiement, et ils s'appliquent à toutes les personnes qui publient depuis l'éditeur. Ils contrôlent la façon dont l'éditeur génère, ouvre et fusionne les pull requests et les commits.
-
-Vous devez disposer d'un accès administrateur à votre déploiement Mintlify pour modifier les paramètres de publication.
-
-
-
-### Verrouiller la branche de déploiement
+## Appearance
-Activez cette option pour rendre votre branche de déploiement (généralement `main`) en lecture seule dans l'éditeur. Lorsque la branche est verrouillée :
-
-- L'éditeur et la vue source deviennent en lecture seule pour toute personne consultant la branche de déploiement.
-- Le panneau de configuration `docs.json` cesse d'enregistrer les modifications.
-- Les modifications de navigation — ajout de pages, réorganisation et glisser-déposer — sont masquées.
-- Une bannière invite les contributeurs à créer une branche de brouillon avant de faire des modifications.
-
-Votre branche de déploiement reste synchronisée avec Git, donc les push depuis votre dépôt continuent de mettre à jour votre site en direct. Le verrouillage n'affecte que les modifications effectuées depuis l'éditeur.
-
-
+
+ Avec les autocommits sur la branch main activés, il n'y a ni état en attente ni possibilité de relecture. Chaque modification atteint votre site publié peu après que vous arrêtez d'écrire.
+
-
-### Instructions pour la pull request
+## Instructions de PR
-Les instructions pour la pull request guident l'IA lorsqu'elle génère le titre et la description d'une pull request. Elles s'appliquent dès que l'éditeur ouvre une pull request en votre nom, y compris dans les flux **Create pull request** et **Merge and publish**.
+Les instructions de PR guident l'IA lorsqu'elle génère le titre et la description d'une pull request. Elles s'appliquent chaque fois que l'éditeur ouvre une pull request en votre nom, y compris depuis les flux **Create pull request** et **Merge and publish**.
-Utilisez les instructions pour la pull request afin de standardiser ce que voient les relecteurs, par exemple :
+Utilisez les instructions de PR pour normaliser ce que voient les relecteurs, par exemple :
- Des sections obligatoires comme **Summary** et **Changes**.
- Un modèle de description qui renvoie vers un système de suivi.
@@ -121,86 +48,92 @@ Description: include a "## Summary" section (one sentence) and a
using its relative path.
```
+Les instructions sont limitées à 20 000 caractères.
+
-### Autocommits sur la branche principale
+## Autocommits sur la branch main
-Activez cette option pour que l'éditeur valide automatiquement les modifications apportées à la deployment branch (généralement `main`) peu après l'arrêt de la saisie. Lorsqu'elle est désactivée, les modifications sur la deployment branch restent en attente dans l'éditeur jusqu'à ce que vous les publiiez.
+Les autocommits sur la branch main poussent vos modifications vers votre branch main automatiquement, peu après que vous arrêtez d'écrire. Si vous activez ce paramètre, l'éditeur **masque entièrement les branches et l'étape de publication**. Les modifications sont mises en ligne sans révision.
-Utilisez ce paramètre lorsque votre équipe modifie directement la deployment branch et souhaite que les mises à jour arrivent dans Git sans étape de publication manuelle. Laissez-le désactivé si vous préférez revoir les modifications dans l'éditeur avant qu'elles n'atteignent la deployment branch.
-
-Ce paramètre ne concerne que la deployment branch. Les modifications sur les branches de fonctionnalités créées depuis l'éditeur continuent d'être validées automatiquement, et le verrouillage de la deployment branch est prioritaire.
+
+
-### Créer les pull requests en brouillon par défaut
+## Créer les pull requests en brouillon par défaut
-Activez cette option pour que l'éditeur ouvre chaque nouvelle pull request à l'état de brouillon. Vous ne pouvez pas fusionner une pull request en brouillon avant de la marquer comme prête pour la relecture. C'est utile lorsque :
-
-- Votre équipe exige une relecture manuelle avant d'ouvrir la pull request pour approbation.
-- Vous voulez partager des URL de prévisualisation sans signaler que la modification est prête à être fusionnée.
+Lorsque ce paramètre est activé, les nouvelles pull requests créées depuis l'éditeur s'ouvrent en brouillon. Vous ne pouvez pas fusionner une pull request en brouillon tant que vous ne l'avez pas marquée comme prête à être relue. Ce paramètre est activé par défaut.
-Vous pouvez toujours marquer une pull request comme prête pour la relecture depuis votre fournisseur Git.
+Les pull requests en brouillon sont utiles lorsque votre équipe exige une relecture manuelle avant d'ouvrir une pull request à l'approbation, ou lorsque vous voulez partager des URLs de prévisualisation sans laisser entendre que la modification est prête à être fusionnée.
-
+
- Alignez votre méthode de fusion par défaut sur les règles de protection de branche de votre fournisseur Git. Si votre branche de déploiement n'autorise que les fusions squash, définissez la valeur par défaut sur **Squash** pour éviter les échecs de fusion depuis l'éditeur.
+ Faites correspondre votre méthode de fusion aux règles de protection de branch de votre fournisseur Git. Si votre deployment branch n'autorise que les squash merges, choisissez **Squash** pour éviter les fusions en échec depuis l'éditeur.
-
-### Méthode de fusion par défaut
+## Méthode de fusion des PR
-Choisissez la manière dont l'éditeur fusionne les pull requests lorsque vous cliquez sur **Merge and publish** :
+Choisissez comment l'éditeur fusionne les pull requests lorsque vous cliquez sur **Merge and publish** :
-- **Merge** : Crée un commit de fusion qui conserve l'historique complet de la branche.
-- **Squash** : Combine tous les commits de la branche en un seul commit sur votre branche de déploiement.
-- **Rebase** : Rejoue chaque commit de la branche sur votre branche de déploiement, sans commit de fusion.
+- **Merge** : Crée un commit de fusion qui conserve tout l'historique de la branch. C'est l'option par défaut.
+- **Squash** : Combine tous les commits de la branch en un seul commit sur votre deployment branch.
+- **Rebase** : Rejoue chaque commit de la branch sur votre deployment branch sans commit de fusion.
-L'éditeur utilise la méthode sélectionnée par défaut. Si vous passez une méthode de fusion explicite via l'API ou l'interface de votre fournisseur Git, ce choix prévaut.
+Si vous transmettez une méthode de fusion explicite via l'API ou l'interface de votre fournisseur Git, ce choix l'emporte.
+
- Réinitialiser l'éditeur supprime toutes les modifications non publiées qui n'ont pas été validées dans Git. Si vous avez des modifications en attente que vous souhaitez conserver, publiez-les d'abord.
-
+- Imposer la deuxième personne ou des titres en casse de phrase.
+- Privilégier des noms de produit ou une terminologie précis.
+- Interdire le langage marketing ou les formules de remplissage.
+- Exiger certains composants, comme toujours utiliser `` pour les encadrés.
-Pour réinitialiser l'éditeur :
+Gardez des instructions courtes et précises. L'IA les suit à chaque demande, donc des règles vagues ou contradictoires dégradent les résultats.
-1. Cliquez sur l'icône de paramètres or components.
+- Do not add introductory filler like "In this guide" or "Let's explore".
+```
-
- L'action **Reset editor** se trouve dans le panneau des paramètres de l'éditeur, et non dans la [Danger zone](https://app.mintlify.com/settings/organization/danger-zone) des paramètres de votre Dashboard. La Danger zone du Dashboard sert uniquement à [supprimer un déploiement](/fr/deploy/deployments#delete-a-deployment).
-
+Laissez le champ vide pour supprimer vos instructions.
-
-## Danger zone
+## Instructions d'IA
-La section **Danger zone** du panneau des paramètres de l'éditeur contient des actions qui ne peuvent pas être annulées. Ouvrez-la depuis l'icône de paramètres
+Vos instructions s'appliquent :
-### Reset editor
+- Aux actions **Edit with AI** sur une sélection, comme réécrire, développer ou corriger.
+- Aux sessions de l'agent lancées depuis l'éditeur.
-
+Chaque membre de l'équipe gère ses propres instructions, liées à son compte utilisateur. Les instructions sont limitées à 20 000 caractères.
-**Reset editor** force l'éditeur à abandonner son état local et à se resynchroniser depuis votre référentiel Git. Utilisez cette action lorsque l'éditeur reste désynchronisé avec votre référentiel — par exemple, lorsque l'arborescence des fichiers est vide ou affiche des erreurs comme `Unable to find docs.json or mint.json` alors que le fichier existe sur votre branche de déploiement et que votre site en production se construit normalement.
+Ajoutez des instructions d'IA lorsque vous constatez que vous répétez les mêmes consignes dans vos prompts, par exemple :
-
+
+ Si vous réinitialisez l'éditeur, vous perdez toutes les modifications non publiées que vous n'avez pas commitées dans Git. Si vous avez des modifications en attente que vous voulez conserver, publiez-les d'abord.
+
diff --git a/fr/editor/suggestions.mdx b/fr/editor/suggestions.mdx
deleted file mode 100644
index 6c73a7604..000000000
--- a/fr/editor/suggestions.mdx
+++ /dev/null
@@ -1,57 +0,0 @@
----
-title: "Guide des suggestions de texte dans l’éditeur Mintlify"
-description: "Proposez des modifications de texte comme suggestions que vos coéquipiers peuvent examiner, accepter ou rejeter dans l'éditeur, sans altérer le contenu actuel."
-keywords: ["suggestions", "suggérer", "collaboration", "révision"]
----
-
-Les suggestions vous permettent de proposer des modifications au texte tout en préservant le contenu actuel. Vos coéquipiers peuvent examiner, accepter ou rejeter vos suggestions.
-
-Le mode de suggestion s'applique au texte de la page. Les editors et admins peuvent accepter ou rejeter toute suggestion ; les viewers ne peuvent pas. Consultez les [rôles](/fr/dashboard/roles) pour plus de détails.
-
-Les suggestions en attente apparaissent sous forme de texte surligné dans l'éditeur et sont listées dans la barre latérale à côté des commentaires afin que les relecteurs puissent les retrouver.
-
-Lorsque le mode suggestion est actif, l'éditeur affiche une pastille **Suggesting** dans la barre supérieure. Cette pastille confirme que vos modifications seront enregistrées comme suggestions.
-
-
- Les [viewers](/fr/dashboard/roles) sont toujours en mode suggestion. Le mode suggestion s'active automatiquement lorsqu'un viewer ouvre l'éditeur. La pastille **Suggesting** est visible, mais elle n'est pas interactive pour les viewers, qui restent donc en mode suggestion. Cela leur permet de proposer des modifications sans éditer directement le contenu.
-
-
-
-
-
-
-
-
-## Voir aussi
+## Réinitialiser l'éditeur
-- [Branches et publication](/fr/editor/branching-and-publishing)
-- [Configurations](/fr/editor/configurations)
+**Reset editor** force l'éditeur à abandonner son état local et à se synchroniser avec votre dépôt Git. Réinitialisez l'éditeur s'il reste désynchronisé par rapport à votre dépôt, par exemple si l'arborescence de fichiers est vide ou affiche des erreurs comme `Unable to find docs.json`. Cela peut se produire alors même que le fichier existe sur votre deployment branch et que votre site se compile normalement.
+
+
- ## Faire des suggestions
-
-
-1. Surlignez n'importe quel texte de la page.
-2. Cliquez sur le bouton
-
-
-
-
- ## Accepter une suggestion
-
-
-1. Cliquez sur le texte de la suggestion surligné.
-2. Cliquez sur le bouton
- ## Rejeter une suggestion
-
-
-1. Cliquez sur le texte de la suggestion surligné.
-2. Cliquez sur le bouton
## Un build transforme les fichiers source en expériences pour les lecteurs
diff --git a/fr/reference/glossary.mdx b/fr/reference/glossary.mdx
index 29bc9984d..4214fc351 100644
--- a/fr/reference/glossary.mdx
+++ b/fr/reference/glossary.mdx
@@ -196,7 +196,7 @@ Une version localisée de votre documentation configurée dans la navigation. Le
### Prévisualisation en direct
-Le rendu continuellement mis à jour de vos modifications non publiées dans l'éditeur web. Une prévisualisation en direct n'est pas déployée publiquement. Consultez [Prévisualisation en direct](/fr/editor/live-preview).
+Le rendu continuellement mis à jour de vos modifications non publiées dans l'éditeur web. Une prévisualisation en direct n'est pas déployée publiquement. Consultez [Prévisualisation en direct](/fr/editor/review#live-preview).
### Site en production
diff --git a/images/editor/editor-layout-dark.png b/images/editor/editor-layout-dark.png
deleted file mode 100644
index 101c433099b4532dfcb8e310f91ebf37a4e0d537..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001
literal 93361
zcma&ObzD_z^F9n58tD>AY3UG<29fUWl9EP{+OSCll~h`~ySqV@?i4oN9UC?s@8X=}
zb3EsKpXdF3_-Ap$-fQkzbI;5*bItmoq9l!p{sPVgh2Ba)DO05Kio3FgA
z4y@Qs+Ogzt^O;bYB)51@jPOCvpU?QVIC4h~R3z3k_U!L!dsaGH&Nq1;R63gQ9rq>r
z%^dL@&nDm{J{^?!7>YV%mI2=d_g{Yev_s*2q&J41JVX9(KmDS}=M=}n>kk+I{5c%u
z#G$&5Kp;qiLt+$zN3T=#BUJVK&#x+fUYhv8pGN*`Rm^`B_1rSj$QsmL@$(CQeggQe
z^Bg#RMR@dIR(`+qyFmIO@yDtkB`Sx^5ca&e+owOj+&=@UF7DqqfgW694q|mPw?pR#(u(Ce{AYk3EHj^b|3$~Rh2Xiga@O{gv1!?|Jkr3u8H8i8h-r*
z@JEhTI4_xhu3F-lM5d6;ODdoGyZ-eJ|M}>DQQ2QRQ85K>U&sMUiT}@j&r{*N6#jW1
zg0x>W_Sc3OS=y+Yzfu@*2g7-Z|37{Pc*y+J?o#kg27dYV
z=jH#Q%0+&7AQYY3BspO)~r;U2vU5oew)7b&_?a%sHK0P7DvLdTr|o&T{(^g3lfo`39+BVFvp
z^UxRA)>JVEuUKR5N(*1Kjz~~191Ohptu_=slp&Nkls%L?l&`ck^oJPwD}?m)$7;nk
zg!#s~HBaqFb!Mt;*vMz9Kd~jxkQ|A0n~|QTKj>Y4NLHx1bR-H-AsUFCM8(3Qu{}|o
z+00*@t$F++Uq3fiqfkwk`s-I(4vt|IP#gVa#$UTM3U(`=(D@dBGAV+Df+VZ3)~hDS
zrevd4%Emb|vaN?UTBFZGF%O3*G!r3H15@{CuD87Y5u7f7DE`z=MR}&yn$C6E*2YokeU_C$
zWJgzc->IRO`AsKlg$+#L!fe8Z{!tzHfr*`IsA-XDzv=EfujOzxSnvsytVWMO6&?!pDKhA!d5RwPmf1J=C2K){&ql+(Q@$OA*67!CXgMw2!
z*dSfZ6V>E*-Mkb+mUJd-XiwIRR;6O(P_g;mmEYE+HIOK`SEuvg0S3F7JyLKw*7!RC
z+_GSoMFS){gQ1JPxjP%pLb=8)Ej&tni6<2DvN2)$Q5JJStQGDH@UpVPPppaAWZaa(
zXNHiFW?B8p-*E<&2XO|M2XnqJfA3;y_cHWl(aUCP^%pPRj(-e^%IlVy2o0Imoq>HS
zK{#eJw?v)9HHnUk%RO}gHb}tkw}Ui=Swd+bjrv2rF|wqDfh=qXbBeq~w21r9qcO|e
zHuK+I_j!ewd9Ka}pUmLZlY+IrITMH?z2DKpBRlQ(^QXE~KgijM#oEXylp*P0Qfrmk
z8hwQ0Bv%r6uV*NO?_8E=2YX{J8;y~-mPTqmpkdN6QmLpZC2Mi7@69x84<-v5KN5`1
z_JbgCAafFNc2IQEcQSS|brwOCwZ5X8F=@wcYZko!{_@lAt{q`~a6+r|!#2I=;-c)G
z`*Ct`Q-me#h`URmN*$K%%MMqaf{!|X1%#hIP$dOHi1=@QVNuJ!yKhC(!Ma^~xzAu}}=xj(R60g|c_Nbu%|m+xkLQ
z*RdnCut##q=U+Y-PSn~S_)NE$#bp`Rr4=7xBQ;6GncuA)5d0rRh^_|WnMhlq%Y^$X7@DcFvjlZnbZSA-2I(qW>i
z{36VwLMmZI{_k3)ObNQg7RQt3{BGATbmu(Cka{KI{uGqhtj<8GC>ar6{L|7>fV6Xt
zp-fy+5sN+Zok|-!VpC33-M-V!lE63E`<+qSM_oZb75rBe^49k&&iy51`AwnS``Kwj
z8<1h+4=VI$_-!5*X(`;~4(^gv4Qg4m)z)-?k1Np#G@FaP7gP#nV^J{X7;pl3Pa0I`
z=VfCx_JV7(^~V+nE8+xyx!mPqa{|@bnjx0UVdD0$)T5*@5$##_^!?1_y+Vg#y80zN3>Ya$8^9YBBJ-0Q
z^WwbE_P!#u|M>o}Q>QcjG+GWgql+V7@+c!9-^}#
zU68LK4$3Z=mPbbc;>n5>OvCnccW#K}BpQ*ph0%`$#t}5)7HS=8zdDzI@Ebywo2S0p4xl_i8air0o2kL#3v`%U3a`B_8nAMu4CO$-U`u){dLFh0pu>MLJiklX(1OmHX%fB$^%<#Xrb5)ja1Aqp|KvXa-*ift^k0s|>s2tpm(
zYcR0h4%>d|I`8xh@|Owz$Bq3X@$;ufqz>YXPAY4omUALT@|J*GdAKsor`M+iN`$i<
z4k^}}fPB%k^BP|NJeX&-P1Rghrt%@8IK2&vT&T#XKFzNbW7CXZq$bEDw6Rb$K7pNy
zOHDKGHK%&BGvH)BQvH0u%b@SBJ78AxkpIXaCW&^~^nYrr%|Q6Uhp@;bqw4;NC#RjI
zNE|7gB{z@!li9294eooK<#6QzmF2hu_A7Z0B|xU3+^TAZ45{p
zv79+09^g=#1DlWi*u#zS$#nJg^(9(eD^C_x{UalB^0kT!#tZfJztBF7CiKBsa$8a);OH%?y38_{k*iOv@
z%|o1@rx_579oK~Wr*wY;uzP#tX!Wb4Sa;3evLmilZ?i&rRsudPWbIzBXI0gx?0EGCbIB$80XfB{=A9UI*@ZCYOOqTOVS9
zW+79xP3M<&%2(GbA-8G97TJ@f+BcW1w!%W;zegPXe0R)F2
zc;5d5DgOog#Nb5<%f>5}gjRFstZEh67Q>I`nq5%Dx%gwI+_4YfKMRsRB6!H?y7R5E
zQm(WB11v$gM`|%c)qHrUGBJg*MLf<-OyESnSO|fY7e}~iU*h5sWMK^r4ycv_iql8L
z@mpu?HEaus?mK1LHYfmW1^pA@$RzMeGfm?A&Y3
z-`{`xu&GJte!WRD4OGpP4OuO16Buuu%-fi#?grh
z@=W0S*@*GU4cm(uQ^zt>Hyy19bBs%gLIC9rl(WeHsyy`bk8lv#zpVf#*OIUstx_rL
z<>YO-aW*c8v2M8IadYnewyK>SCR&vTuK}jGM<5F3=kvN}F()-<&4!I`8K>X7b`pi5
zA4M`sYht`=rfRIXtZ$DPQX-G7x40Z{y<;M!zq&=aP20~EXcd1!Jmw5@I5w9g;7AnH
z(4eby&F{WF*Y^$iwy1=zl6H;cA@z%U`FZ&h^8;sBfk}mjQDHfNMsY^atuGD{FOfIK
zR3iA9J=ZA>KkFijpv`#R_K49oJm^w3oJ^QW#&)V?f-ipxiaK6-z#Mo&0G=j7{pNLj
z#6U(7x|gIo^f+whywvwj-)(Q6Mn9@nK9SdcoR_Vi-2~DBg6;J2Ooel*U15>ixqHzr
zR9dmGc=OnHdajZcje`+B;V$hL_M_N9Yi}>x^uN;o-P2eQESmoFT&o-*2p7f+HXE)n^6C*P5Mb6yMin0;H!P5Dvqq@2=8Z9SJfPTDL;r0=ardD_glRMo57WJEO
ztVe_k?XTRUoQ9AI`2||p?aW9q5OL!9E}CoCKA{{$ElHqYK!4=KiJ8pPV2h-kW`^GQ
zG$&0PXJ%&5a`jifhKpxac7I_qKU?pDWIZrb&E?rk(9R1MwVW6`PVta59HNikAC?3*D_8ddTzm{g94nCk`qaR;<^4y>>uA04*Dvl0)5+lo=)W
zEsfJb^I4B=X{%|Lwy{^oN^f?`?DRd;Wzg`<6^X`iP&5T^uXav
zP(j(d6IYc&EbQWCJSI1ra7HihHQp^{T_(zB4wTPjZ5j_jTS2WNA4alX!(!
zycr5GL4nQA*vwEjzEXn)Ra}QmKRhuG3WVeFj{^vhB7e`x#inmLXuMvMWt3e+Gq0dA
zOq#uJ?9ESEUh_tjOPZwIl>Z1yfbG_L+04}p0q$13UOIwed($e_QwmU_%_?qLu2!8B
zqZ22yJQ15t+UeT*dT*2Gu|^8U9WE*w+NZ}7rA*^XZ{H%aCu^3gaM!Dawyi#)?CTuR
z*W4bhw&lzYnI|WEsPV?1`gAfhEXGzUBDUPDv)dJ)L8i3@oQ%BVx;?H+uN0pa(<;>&
zLCUQ7h2YjHD>X;2+Ge!I9`aIsZS&Plq*`;s=z?1E`*;6zm~H-WeE+D;94h;7MlzB>
z?Bcy=c2X%Y#*edhM+2F|w(XBQr7Rg$WZG_+QEMcME7$vD5*=IRvsd>7%VlxmgWnR`
zc^ysgjr&A@=e^Ncy?Olo8-eiaaKQ&B2`6?|{VrOiMw8P%?sm0%+<_;(j0Hm(8=Hp|
z!o}@gAe_`puG<#-<+n#%PKz<4O}ZJ^Cu7vU8;6azXN?)HFC=yEpf@WK3t_hrkHBG{
ztUCFSGBPr=n!;yg*v
zqJQ>kt=yIJ>Uq?(6h7J_XAQ{Ra_B;Js5hjvg&y_W7=FNU8LQ`&n`UQCkv+Lht}L-f
z1sTPip3z)LWrFI^ZIW~ZS^2_hx$6lDxC`xJ7Roy=TJX9MSpmx0W5+~0O0aEXvgfDS
zCZP-aX)gXZn>hT}DkiJls#2w?zWcg_*KaXtqzv}n)Nt=wG1dEt#uXWtwjiRQ^aWv(
znokx@Lt%UiG9b{G@nUW5=MoYaBPNqgLOoFjR{hcZqPL78#O$~sr@qfuI^Xr0S{%$b
zbJ?ES(PZaln^tD!q&%%Ly&K7to^WIPcS@K-WODNlXDCPQ#IpC++r{bKCy}{Yjob2D
ze3H{+eCSu>15(YCqA^L3w(`?SFkR*HiIJ}J=%edZW_wG)0R|IFyI?UP;jMO0Q0ZRZ
zHYBX(3cenFa=O?_`Qpc&1WE*+e-hu!&wv!fanIWWZi@w*G=oTrUyaw58@SKGpg+v+A`43zdq}zhuy^}rb
zV~c9sZ_#&XUBR-RYp6y4~sbl#_vHmcwc70W}6bp4cO$vf$QR8#2fZ
z7dWZ_WA8;lNpo!{7Pb|WW=jCr`Fui=W3vV$MhLwOnD=aq%c7OIU{+6KsUSYY(@u@=7peKt!6mZEmbZVh5$(nNXbjUYj2)Nr7RdUX1!l>sZt^z~krsZQt^G~De4GGb4+9{F0kWye~>
zrEv91;WMUAdmxAV&0p@~NEFM>(;T0|0wN;%aOf1V2GVOQCER=veurFbPkyX~gpApw
zb|TgcacDKfc^FJZMCPY^k^){QF=wV#OcXI3cmO-usGRv-W^@6`p-s{vkGgbIbX@H~Q7smD<&|Q!T^uzBgBQq2QxxoBXum>Yd5LgaRWl
zjOXGygxz9j9&FReETmOA+|E`cbo&k8S%lT_aQivWw#qoC<1Iq%csA41k(Zmp>3Dc}
z8K5fjBfOrzz9?g#3)x~b&W5)UP0iM$w9_@Gcv
zA&Y?-7<9oZh39fVPYp2=e7IzOu@^yDpsaki(F&d5Tj&i^)Hff^N}PCH+I$*hLpqZu
ztzSsa8`8Mnpnt;Kbhs=Z!0XLtmQw^Nlcn%H;S`5UReViz)nlcuIp^2{3!e#cDY-so
zzi@&Qi0ijZmK+uL2(HrY9iRYdbMIzIgy@X|d12`atOjzR0vVnJ!h@+gXOD0r?A4i@
ztUVHZ6l&yy2vqGDY0Uy!9qErBKdM2fzjjRUB6_&(OlsPX?Wiyt{8EAWdATSBuO<1n
z7qZsDobrh-ep7f>hxXU?g^gj_M|5F
zgL$t7@MVr#YmN1oRF3kU5|ZdNg=@m%Y
zqG&P;6Ztr5@=Qe8VqY+^V`bO
zCCs5-j(vyeftm@rF6#x_5XqNgIneGvY}8)r>3s>G$t21n>JN(e8iwJ$c?k5nZ{NkT
z!POSci8!ym?@#6{9bQ81@8}1~Tw+Cw>w@Q^NtL{M}JC)S0n}WcOxz%1k>Z
zQq*&mdT!3$Fm}>w$@K~13ZKg`D&uN0t
zok9CUw*7OU6YRMX##g<=s6%+;GQmW`c8(EQs3jpn@D
z5#W4f0+BH%=nYbhy+t%j5}z3%W0O&pHeG)v6Yx;Ey;xPpBc@~@yd~vaw(;D3y;G;C
zs2H=6a#8xAE+h5L&ZsPf*9q=){n(=q3uUGfo@#}Cy27|ixX|;JyXb*Lz8+BuFAZcv
zeldrJBTxrXm!WS5W`Oi2b;O%@r|$9xDRF&3YE@n^8g=JwP=;weT>-uF;^gDgCSo_D
zmXBrmw7S<5kS07qW$&LrS|0vpd|mfMXQA3Q?)vuX0J<{kxqU!h?D65Y4ClW!gMO)c
zn^^kCYT}3P+sjQ`uFfUP=FN(A(i+hTD(}TiX(@jy+?ZvJxH-*WnK?^*UEo$;yh>Tz
z`Dmxa{8B?X`WD8nt(nv##H`HftH^fekWqDh`lx;-F4uhS!+?!(*!yi~-#%N-`H|(4
znkh7dt9iYvgxRu1+oer8|bnv+9$eK)X`uRP_=nS3D35JP}GO9O_>8FOWC1c=am&
z`V_)d4_i-Mn=+2;?u}ty1JoE5k*lEUiiCuOmgC~RTQ0peZI$|IqEH)1bFNw3=RAX(
zZZB;M9uOG{xVMLVvY9M;!folz9*jl)InLNecE9C{ZMw`f5Z!LN(kepexZiiJ@gS!V
zN)#d~;I^Fw%{F{$_d_NKi-e`L30hI4Q~o^m_Oei53gXymp)t`SfdUlfJ7dIzui%8o
z*KEA{-Gl%pyU!@QlFrge0MQ4Cgn;l@a8GBo9YmU8}uG2y3NdFg6&^HFz}s2
zUMQ6e5Bj^wfU;Z_F@yZkjM8N
z-YhkT8TVW@67^v1U2izE^_~UaeQt~sVGvZ>i%C7Zp}!iUf2TfYii^!LEN53*-U41uN_+0mf#@2Olkt>Hl1&iZh!F9
znZifd!$}HujUM^!s0_1m$Fwm8XV(3A&;5guRH^=gW6o4sTATA8R>0w8ks-6o#$Zg3
zdQRS3A-vNVE3=apl;{oF0dF?pLnQF-NF|C<6TRY%UBT-58llZl7o~pS$w}CP_f2&Q
zj}b9jmB>c|Qh_%tWEv-s3Jd2Q)>@gDWAxCI*1It3xUAOO%f26zBl{j^(wqs(BDXq7
zPo{~zb_V#u6v<~FW(CXP8q_N6P(mX_Z{Jd#V_jt60c?-nMV)bfA$3zAg(12=ZA+p=
z7b!~{-_@-=%uqYqkCQb>S|M5CkVs+5V*T<|aXj|j9hHe=8{y4rIOH}5p&$K#wTTD-
zq%GH%q}Gw5fpbHmceH17?xiO5HDBpMj5=8Cl!Y&px29@qsl4y=pykUbJsM8K{Mf&p
zt4hf##@zy!RCnN+(Bp=ZPgC5eKN_#Q1TC&Btkz(AqMM2Ap5Kc+<(2oF%&$=NtsX+Y
zK>DR#*}XACZg-7G!q$ALC4{)}*jVE^Nwg#hS%^TS6;tDVViFo?>ZOj|q
z=FhR*OzaYt17CRJ$f_Ohe9TBKFQ0Squ3D)nWvyxEw84_z_=H^z@pL~_syAvYp<<=Jj+nKNd%C(_nnmEI`yzA_M
zk46dy6!C;%~2%f2{iEegxCC5`bGCRdrRc{fPNm7IhH*R;?OJ!Ai!~uE^&PO
z!08VlB*|FOzpdMX|)SQRD=IvtIj6fM*$uCOFy
znJP85vQvCD`mGyc1+cMDE2`&et+mvm&vwW0
zRB~E0zTPZ*3lBA|MafdG&cUP2#)#2Ptr*Db;*Cmjd(O75bHJ{RR>EZET-9u82b8;X^Ly(A1yYs={kOO|LF`
zr*`WG*;8wDv#)N=`yNcG7>mUlkqorINJvN|$<=mS%E~xMcrG7#0tFEO+#v!F
zTDwZ9H18fxSBfab)$jNbEWQ4S*)1Vi(EVBR8vDHEdizl8x!UQj;39|OUCClC{}%$>
zEccU5)y7JFZTm2x*K@i<%PAIf4X#;$n;r$qVAk_Z^#uf;!m#}bdHX`6<{+lAW-mVL
z@w`uqoQpOn#6}El$p0vW-$SFnwTc105H~_`As@alot8Z-cU4trk**!AYfM>yC5pBFbBry1tqK|;^%6+Hgf@}2~DRBT?j{f%T1sWQr=0vIpSZ}h#
zun^kPBsNSQa4?M0B#qh&*&)mYIXQHF@a}On$5y;QRYIN>2N(^)_PxhFVZ*~?cUQQT8m*v^z&CRo1
ztO-rKis^k?ecyH=;V~M&i4?VoT!5Z2`!5>TZoqGVJSDgG
zf*PT+^FyoF!7vk|<5&__FVgIVQDX6fL@*)!ukgf?33v6Ar1RJ6AM|HZ|Bj7_4=Gs5
zqD&Aq_udK#-(K6oT$u$DzCLW}sp;rb1zx(2*JX)5H7g|fAT4SMIiJ$0XWeX3v59mY
z#3HoDj#uKN6>JZ^G9{Q~YxT%i{js7};|fJ%&l=|$CIYELZ{}0Pf7iMa;>u%2Y){(N
za!gME)~+VZGH}=q8fcOr902wqLij$HcaDtuGhq`x$MOU-^kP1GR_1iUkTUG<1=}%;xRJQMJqv!3`r2kBL-HQOMJ{y&
z$ri@4W*H^VKmh>h;Yukt^9*s93Ke?|c7}gI1N{*MW&}*$%zrSsQD#rT6@Bjk8XE4E
zMxI{{m(9s5d(W*@3}UwK))bH$zzTjcWy~i&@3W(*TmSMMz*s8$3IK&p<#87F0Y;L%ll{ZcVZbCMPtN{(-pc#zI&SW7dfQaj;ThU
ze`J-h%22!!++@}~EemzO26uPaM8S9=1mtL|=w#<+ZT<6n*~I5bbUJW?;3
zD%98h!fQ>9N@N7Iu`c$n4kS}!TfM$@f;YDG@lzouP3)Em{+3Z$x#`X
zR?K!ZKC(lFFqsI2IQQPHXDeGWLroY2Ib9aOzRk?`xe-xbM0cs)4Htqiow=mh0Karx
zH0@s7xqW=&OYC-c)UOhWxY5CjLibh#1TRneGjyuqLEiYmNAIn`-->;5h>gLDD#&Q<
zp6o4`K_-bUl%=S{9p&9L=`7n)^Py?ZtC;>N?h6Sk{BSIbAG}I(FYDt6pdOF+l4J4I7)g_Z);Q?g4yI
zeXi~51JIc45Lrz~!Z68^gfx%kD&kx9)Xcswl$I0oJ8sS4keFi^y<-^?z6uR}#Q(hE
z%{HUD=v9B-%kx8AwJx@2Dhn5LCtJ|Yozfmd_xZ>57nE(6XOvX6bNfQ^N}`juu!6!M
zc@vYgnd|Qx>K4N>zpbvt8AT&utoNO+nztL*nVK#w@3u+=W05p|;c;|W-Qxywy2=If
zB1#eOAKj_^V7*wjo9Z7~L)X@1uRbeyv+g|bx1B7Bxw*p5Gim0wDxzFgP8G&S<4td3Q)YDSX?QX4bGAbSC>*-Dy>aKtW-mY!6KWhNG3X||eY
zTsVlgA|O#|4Xz3g<(>pT4x|!7TuCoR9h7)Z0V%`wq#r`1ir-&{9N-}?E#O?Cw
zZ@FYp2Rn8_@7!#dftAVFjDQOj;@$#GdP8$_qHDwDK{o0-EO9qbGHRQI3I#n>e6)6_
z^hb~m0^)9ZQ46`N39krvE*YrMB}=!~9ozZnOjTIOBem+2ui`n*n@>gKfhmTwGVDf5Cws3PpUx%r9P%p`)1
zc={Qg&XV1`fr{A5(`vhvynq=eG2kJsLHjTwXvU{_pU5I(lYFFpH(G8cy_V0A8aY0$
zVdgalf`vBOTXvo;vUPCL(F}bfufLsS4kjVk{?vMvQ
zRf1Xlg+w9Q{ap>tCZJmy|H5zI@@#N6tuZJ2qoQ)rMfz#F@go$1WX*3gKNV_}Q)Eu1
zGj$tl6lln9+a83a9Hy9PztVY?zPGfr^rQa;d@7O2%72CGKg~#vx@=|KAycQZKoQtu
z4mgacrciRd)Ovhs>3027`RJ39uyV%>&MC@PQW6{%a3NpR&i2{U?FnwknEG0}=t7h_
z$z+d6S+jVwBhps-0BR@jP@yuwqy|(Wg*cvPL)!H-z^nKiPbrXKU*N
zy25Bsk?9Z44sU?Og^r$HDwzi;=n}E&tgwyw^@bN_-kOWkUt
zJy7(TLw|HIRhrNl)~)KiqR5xuwDxpa+T$`~i!3_)kI
zu67@sF@pFB?-04L4Q(jbtPIYZ5(zhpAVN%Ig}}{OrKkR&y_ss}t#mrJ+wwypNXl>~O*F273{RG#RLI^6OFH`CD2D!>L3cAtCF6;7_M
z&+%^SZr)oT$uS@EI|~pJCK!*dG1&7LYXQE1JOGE+a%7{-JNtD<%S@NBzjVUuA^U%b
zxLZ+WwYnKA&}2>!^i40)Z&i)GZcw<@tJLZYOQou`9Eb)0kS@kFt1_7=8{gcUz&6yz
z+v5eRwSn6C*w-ta@{Ol^ND;R;KAkKiTyGfNsxb$+a%M9~(%HEkMO#SV+#ltR
z&Bjd(Xq@tC7-ujkrSj8Y5Z};l0W&fN21zfZq`K2Pf>$?EF#<$kAGJz#Y4mIDW768h
z^3@x|R{?eabgd8Ii-1A6EdWVQgr+U%?_9axE$UaOG&jeaMw@QF`g
zp6$LfdF}MQ5_-KB(fyIeHk3=!B0M`+Cgt>w_&1|SWi~Gz2kRf&DasA9vDjY50^h57
zux=J+lxbP{`gGXkkt1qve7d|>hI1Qc3kP{vN|GNGPiv)Edo_ED9ulHqple#hQX0`b
znNCUAl22~y2=R4@XF{DkKD5>W<070!R7oDr0hOH>$~D0=an*BHlh+q`-#$j?9H0)5
z{k9DxDkhDiWRChoT@?Hv4f~G~A^6`y^9cD^fx=*2zKE9kb9lsUR((tGI4i>O`amkX
z%;i$wE=6FW<5|rV-`$xg{})j){TjO`W35+4HFk6Kz(2(?++HY)50Bw13+>wvxHStG
zrE4I>Hy8Qd!FO_2S`9sgN?H)H8Bl?o3;_bL0l!nE>UAczXk@i*F(niTAoORmUa8*4
zdvAagG$Fu`L-^r-Y3pq?!`;Q(*9NZ>fFM?X91f`}Pt5#yx<4kp-?Cv8!|uT8I4{(G
zp~42ZL?a&IST-o7?#^%AHKiRK!qGXtg@RDcuT2LHJg?@?LKDsbS_m_?@VQ?SfEXwC
z2EXT~dfSbM!0{t0y(DS_I5`J{V+8tBOC7;$g{3W%o!`%(7sSTB*B2OMGiz&WJ(RvI
zarvpfkGU-eH7siF=C;dj?IATit54KFDqfu)xO)ik{oTGqXxnoBzVf@pr6J~!>(Lz)
zB^E$+#^2|$nI&RI0iDLE!Pm0R)U1*zH#;=DOuTzS)zb4i+>%W1G(L-CUUhTF3Dfdb
zH%M(uPVt5(*Sq*PwN`HCR+796>1k?o4YE^G)XFY+tEshddHB)F-1%-}HFnZ0+d+f1
z+EJoc>!MY3LEV#$QRNXl#6%ErWl0BdLpWnD!gsa(%KUt|UFs|EuJmXhwWB`DX1Q8Xyf&m+xcbotY~clUgADXvrMIQEOVF~gD8R_X
z-9_(CqI!vI#nNUF5_RXLAVN^0%E7RQZZSev{l2to-#$Foe7tBglp+kBOuUO4$&`|_
z&gC)$P!>?>4UtO57KOflv*)%|)g|SB-Ctj6wKg-7xti$M!W)2b?4Hj%3+fwy&bg1l
z6qSrQ)s1qo_Ezt1Z`c#~SG+D%5`u&i+!)NcZNGox(Kz
zJwH%z+OxjG4ogpEpTO2_5LO(;g-JU4wKR?ru-l`74^gr|7R_L
zXnOy%sWzr-!%&S$@%gh%GK5;YGfrcfw69t@;H$9le8OC{vA0t1EI%-pr~*yvI039K
z<%gm*Do064WS$#)wRHLRw$>9F387@11~_$73Rl4;T^4hz7aJ)tb|~C~VU&WMc`iMl
zzrWia*Pg##AeBl0x!Ux7Thm49#(K8f9-50BfQYmkXkA~&C(
zr9_%~d>JsF?INA)`Z#a51A9KM@t{F{80fLVvijqXn$amRP*EcR7V^rE(9j1oj)~$N
zs}nRqvVsE}1?hoE@IHpsF1%wiZe8}iQ7c{H(?onw%iweSJwN!Ik6OoDB2KTV2XZ3fm@O4P>-&P92lclY3Jf*q&i}a0oN;U|E6!YK
zLP6j20gX*b-9!{68@!^_Vq0J9_T}?s9;iNc{lcr|U~ryy-%_@|fW6v!wnOCkW{*I&
zulWr$vd{-Ko9BMHB&r(IF}|5-8|r+;J@kxaWj(BDun+N`z`7f_hZBFcTepgYn3t*fi=o*(2IeHf`mSoymx
zOKvokiI|PoyUdfqwwhoid+kM5%-SW<#=eHsT@l<3vpk9vhI;Ub)x~<%YQhdc0#;lV
z+}JFHfErb6AN9TUn)>Q&PrcohPFOZmDlFUjWyaXD$BF%`S9vq3Up`Y02ApWX+xzS8
zO_u0pmM9`lZ2Kx(H}8#4+y4uvc*xB_F=P-PN#i~AXlVD{re-svw)*8Kg!Zpzz
z$has2*Y3u*;1j3w+i_95XH7);#2F0-Hc%>skWE;u+glAKyFh3hIggX~Xlx+WwhS@=
z?|PX0Gew=%)yF-Mngt3b9;6FGeLh4UG4%cFz4TnhP&W-H5EL9_?!1@LJa!DzZ`mj?JDTmUbyGz;kV#GQyxQ$IKISfVq#TK*mq)}+h5F__F}
zJ4JTdw{W?G<4^i`un4?7AmZ;Uzhg#V=qvRE$KO+Cupy+aDdSX7a8LoFob+s~W}hm4
z5P)!{55?VOP-iNYf0QsZH{E`0SRYI-EN!^9SgS75cJ@Ca!=gNbKS?O-VfI;wJ!>*tm-|-Jb^giG3IieKG&RmO*a>DKP0oJNSYOwV3DlH^OW{mO>4h;+tc4S
z*uYFa_S+2$k?n8-St)pDH^;lldYhD&x-*lyER#E$tv>QzLVf>y!-rS`k_Xj4
zNG)+lEV;#;m~7hL&>0usA<&a77%}c#DSlnG0%+&%Uee)Y{M116@T;8%Y6C!3Ka4za
zZOV9n7cSxK9ylz0GErj$JV?X3$oxwZ3fz+Wfz4^elRt*M+&KmH$teg_M7Wg;qF$@Y
zECRuXYpauVb;eezrznBjd?g6e`SzN>eb)wV5Pr^g8T
zrSD1n)t&!o1{?Ziuup7_;w7xWxHVfiW$kx!Y$Hbe@juA=KFm%}2OJv*!>|0|x@sw#
zdMpl>(`lsXn7bb3s-5b|`Ov;(iInqsYfCr6cQVpK1Z*WcSNBf5P~*vH%aB2?-;+Q0
zB9M)OiWEDxl5S{SI301ba<;Hm0x+L|%uA*+N0ByN^*0`ud7zR+qn@J>yL+wsd~SPj
zEhbq6EES%e1@dI>n-n_1xMA)a`CWXA{J^eXDtEtM`ca~l75>c%{j||m_e3`|_e{+g
z7nR`MLk~o?iiv35Yx>x?on07?D5&Zy_4+y77Z-8ewYD@}(;YW6!I=uAS?=peFv_a<
zUe#0Zx&V^GP)I6{(G7-1grx7jR
z8$aGpExw!h$JFAY1N@})-?*)R$o$7!aoSw{cUQ+sw7))LT+9ZB7L6`DJya_XztxXf
z4S`fcX2%Fl(7-MliPnK9gDHaSz#u#wHH$$;1{43bV67@JE6S0>S;N`MIcc~jV`-TK
zU`H9C@x19TS~A%KOw>B~kL3<^?+afc-sOFG-&n|AdpZ2)LDmuCDi!t#^0gek9}U1!g(2~`2&5a9eh~y2~H_na1Ush
z!7A*jeI$i|H}x8U5p9i>>+b`D)M*jc;LyfQW8g&*c{TxoffK-72+tc)9k1E!gu+vORDSs~WlO2s#hdvb~?4J#!v`9GZU-N}O
znPq>xyyXDDtVn1b9QHDVaWMm~t2)Hb=Z%MyRL<^9^VCyeDPurLaxT}%`6GM=jaFN&
zQhMO^0ZhQFE4&Ti%t*{0-3)g|lu;@BqN-f%Bo5C`C>BXdLD+cL_ISG7
zCBja2eyJL5PeO2H9-urmuzVyraZ1jhzG;yB`C5cOMf!s?`p@BCmFNDU3s`Ywv>~c(
z?ufw5??y8;C^kh#Hs-hB2#|!j+yZhU%`nQzcgrz4U0_D}vA|LHYuhxVJ%MVrEg?RY
zHe#fc^3d`y&ixV*a|^4!`fIV~vPczo%{~yI7CwwkU{+t-pw^)zW#VU}c2NSsj_Dsx
z>^>OX4-pKoIvsg5Al~+h3A_A%l)ZIaRa@8hO@knyD4>$kf`EW@i!=z*4Fb}e?hX|N
zq`Q&s?gnX)?%GI5cjr5|=Xfs9x#GFs5C0(G+H0*j=a^%T@f+XK*mFI~9bgz>db7^z
zvXRr|<>R}w`su!MZg$b)p#5P=6-qRh7iT*!|&B
z1oN2&AsH+w3`{zy0YJ{rLU=dU5-JaziF(5%LK)sQ8%>e8!Q;^9Gm_qi5;5zSA9
zYVCKFQP}~%1uU3s9x&Zl;b9<#G6KCvdIU}m8Syh3;=FEZiVuk&QGqH}*aV;fHHSYz
z0+dy+tm?`7|COI~mGsR2FWQ>@6aU$fwj|)vl<{4Q{-Ata+Bx-l6!4
zl^WbKk9l4AeBi01R|&cf3h$pNi{+9r#i2!5Tnj8`80(~S7wub?vK&WbswXNEc-8_T
zP%=;;sgXp?ftmXomy70wXYGGnwF1H?yE6{8lt#>)$0`Sxb
zs940IM71Xp1z}gX)ej*rrU%-GDp~<`1FqEOgqU2m@GW2#Jyb`Gi=ly*BRoibkn8M8
z+-~W_idT9xiL#E2iW)VZ?L>?&OR5bwo&fPAF6g<`bY;qfbNPGW!SBZT&jb-v0oog$
ze|y9xrlUw@w`rVNbZvB%6L||k!-(Y^N9z-cahR~V{T{2Ih1YtveL||8Cu;j%)2YQtdoZcP1yMG~K#)yuh(y@5dSe8egzzScIlS#Ah
z-+l7t%^O!FbJb@~w~_tsHl;$W+!nZ6k3MW*jgu6#>S8UMqbtP2_5Z(+XWfbdyj+K=
z^f=KW@&!MZyJ%!_;8_{U_p;lK#j$iAqF2#a9!^-P)|!VAa=9v4@9#FL;?q4{Sm40_
z_Q@s{lai;`xEL_CPOt&UjV-4G3NSs1R!(eJUsSBKpb^v
zpjB!LFzlFU32=H~`oQLa%LAVW{;Q1bR1CHOih0WV5;8JTt)fBQ)n(5|1A>!vw$4Aw
z!n;JTVQfU7_2?F(-GB&*1eH#)%1Cc`mAfU;<7bS_JTHnEraY?VEN2(a0f!0mS1e#y
z>CE@{adUs%^y)uE+H`QmE)J^F_#0jzc<`Fd>U^QB{a%akAm~BVgQSLOjEWh2iQ-d#kal!Y<4H&C6yXo}-fc)k>wHb5l?Ew@6->lb%@2IHaI^eZ4hV
z#6MJX4f38tW@P({#;b)wZFgq8KB1VCAU;r!W-82P8+*30Ya|&U7$E#>qFR7z&uZ)S
zLt{?s&1h#N^T1<#QiKE82Hxu&K}JSNTN3(G*-saM3I%Sp!xi9but#%ZkKZkz)=&of
z_aAe(ZsFXJfJWy9y#1fRpx?~Z->iKSe&?&6&{A#ls61+Aaj3TsjwM&mkBhHZr-^Xw
zMC~N)kK4)H(|3-%>Dm0@5LU2AIB7T7%|fKrD|=E>J7#f;e4BUxx#~6SJyZ|(75W_7
zit#W$2)d_PZ=ZUMLe&GdGRmWohvNO6caWr3mro_UhHl;0e58k=cUuor&wO}Hzxlye
z05*GizUnva-_#7q6-FL|L=k#Vp1_v5T|Nx!qNSzP#u{Ll;Td!b>fCJS(}-$GwBXET
zdzb}1Z?Rj^n|)*R`-u4^ty)t{2zr^byr^(;gX6L>LE^BlM;IJF!1~T5B^`jf?68qm~tygzni*wqkeap<0
zG*F6MT3UWID+tRkgY$6*R0U}zg<-^)5V~^P=WtV?A2^e!SR^4!MBKoF^_5uvM~c}b
zrf8vdUvKaIOXP^qSX$p8qTzys){>in$5f9jZ-?uE)Q_u*COd4>FF5a?`zK-oOHZrh
zY4|%(=}%?P?;yqpUWW;p%bP(i%e}P(%e{?Cos$=l;!_aGXd`GOljq($tM_~Ftv>82
z^#(7QqdUGAFjx^5=XH|c#c{X@)GT>3tfX3R?~`|FlYe)|ho|BVNjLO$1(57Vic&vF
zQzq`_K}B{I^OXKCyY>GlqujX*Kz}E7_-40$AFf`irt6>k!fzra@a^CCS=b-Yh*ll}4Xev29Z{z_r9~BbEaJ~$nxSlhIpP0#l>hltnBeUtz*A!HFkk%JU0>5T&HXbL@z1$ehzn-z
zcmu21gFkM*=>%y)_uoF{uX?n9j*2W7yfy%%YGSL#{=PN+L}HAg+^Q;}#F)Px?SIU`f3pnHLQQ&t&KKB3I8;gOP?t`t-al^+
zimxYdqtemOaJkv?+x7M
z<7Qodw^p8to|6B^0rac~VAoCIs_hGeP56IKUa-Xer@;XVT?#;@W$7a5GXHHkI*NFf
z|0l2H->JZ!)G)BBxaOF&S13ji#sB}$hvI2l=kot$0(;yCE04cnW0M8>
zQr)xue{Xw#JqGNPehv$i1-$%&m`Xp)-v=KKxlYED{(oXz{=8KU7?;-6od>pV1Q4j!`m5;v{~GWnR`?n6g{z0-x1FAYvn%Nx+2FT-nsHz+l|%rv
zixh@`JX#+M!P-)j%w72;SNV!QTPeNd<-7OdKp}|1itk3V-p*-R;9PE+4P1L8j46e~
z!I^)cnNr|t|8b-MA>t~0Zx^yE_Ld8l3@7!;yC-Nxc=)ifCL_iE*D!70N5eu7{eZbH
ze!-TX_R3ZI7ABUJ;nCY142XdG096?#ACz7e=SAGOF+P-k$pn;Vv4dn^mO78
z?u6eLna_YXF`A=9UqgEGk2Sb!0AKO>@5@4<0dA*%Noe;yg2DaWFMLd5{r+>e+1~&9
zqZ{0&ku``KYg95^KX3P#W{r`a?hBzK4lRe#uAduJw4&$Lf1hd4T7)|O#o8Sr^;huP
zu(?)PuV=>i$CyLq;LZ1}ylTq7BM(PhsId>Myc5B6%b)!9`@d$pHm*+X-!~9;^xf+K
z0wz^lFe~x|o_HVn<@^6WktCjYl2+E(nMCZ<>^vb>ug^)wZn^on9GhMuY@+}Er++Te
zKUUK`LRDq+1sS^8n)QJl`XT&q^My12g!}KS
z9=57>J>h;2S0sBz-2yioRsYxw3;FV8)1jcV`#xVu+^=bKth$f(z&R@gxGj(I0lNU)uG4*_>Tv_{yVNt5j$6+#Yq>
z7fIee-gW7mW~l#mx#T>A-|=`&X$VzOZz>8>Wa{|!DjXuNm{P%&>-II@rvAG0vr>Up
zlp_in(g9n|mr0;p@@nqv=lv%PE+KWrf-?QpyN
z!f6A<=DYXrC0xxu@AJBFCSn4JUC&-P4;bKobAs;Z{5Ib#X+2%=t9%#AJcD)w<_APc
zc2MGE;N>xZSsJmhII|Bl{55*Xj$RXwRxk&KU3ReDMlQOQ|F}(0e)OXLUxV?R0gu*h
zGUGk;b-}+L5H0;IdEC*61a4V-hu!6u?GQl57|GH~_g06V4cBG|C0fw*|J%I+t167K
zd->P(lQobo7v|pc9~Nt%V930H$G!z_RH!I#Oc`kc@YrBeUf}H3OHswp0ch|(_Z#Gd
zTW&A4=~fSU=>L2Z?9}1izhVJ^{7Tv+{ny3+S}?$5H(6m@^&^}x5bm({D;?f-W0eV-
zxQ8As362*l&is=Ezs9IeCD~db9KZ5gz4Sq5177Ije_b4ZKHKgSc#j&x1sS)aY{AZU
zIRV(B{?Nn^i;PzM!Qpq6CnaMZVkgl0pmZUx-P6=6^w$^)d_q!z*}}g$&)~P?$aPnV
z?>Bg#W;G|Bs|}d0&_D@b8{6lTPx-&j4NXW03kxY!tHND1P#HJ+n2*X)x{H5Z`CnK3
z-LF*tb+6O#eSt0tq{YVagJHEYUrBi#{7d+N@A3(b{ikm%U}RaOes_wZJZi%{J}p$8
z&R*zkO7r$sE75r<0U*W1|S8~vx|Utb`;?bq8NaJfF+DQau*Nh
zyO-Lm_FGwPFqMKOK4ia8Ewo$*8S)53P&Rb`dJ5U7(7v6A*Z&~j%=`3p
zGyqrowwYiY)AqeM3bFoeO@$`Nq6j7h7j4cV2hWRJ&{(q->hYBbWvwUosHDOLeNeI+
zY#t9)TJXR1R@OfF=onRWo>We7FTRqNyOzAEVBg>Mj#5$0C{KHDNFUw9%R
zaTbJ-&-P=5?Nv~=&*2?`F~00_d%gD979oH4uNv|8ts;!tPsm#AW|>Dk*<`Bh(`H;3
zkw&+f6<(YBf`u(@USl3FRpTB%Qh=*%{$u$Q%^yr{o+nV6WHgf7yYTQ`VL$90W+7^o
zp%oCd+FG?S<#%v^C+2chW9RrV+L*gz(6NN!ib@t)6i6*pjoS&&+
zgP=Rr^T>hVJ8M8#)Y}+6)BvGdo3G8Z9cYL;{ZXshP!9?UgR!=zIx+8cbVBJ0gL`Uh
z!^isKBx@@mY1)N})_osy^*2}V$~9`u?n9z6427OerfqcOTJa}aFdFAx#Z9MZhTh(u
zmob0fkuOEak~4##thxGOoM>HUd}T3+|M8B;uGi&3S7zO|TUHjzti#P!_mUSXNnRFJ
z_*q?QVYLW=1W=TljN%-o_Tug}Ng`GKdxHk(D=#+jt$Gt{WQXIvs10WM>AM=^IjZv6
zn=OnsY!z19ekkp=kW6CE
zL=7S$!idy8G_8Puy5~m4=77kI_lWj!^W&i+tpwc-y+53JnmbMW-vbf+cCmT*NJ&$q
zn(xlV`TGTgUu@S1ZPy>z3(mQyny$A3!|GKB^EGZ^v)=Hp>up
z!*c=Pa66fxlC7mOw!^bACk$V-5#p_QwN0orc}9iDGVdksxB4M^d86>^+Qtd3B3;Qn6Fv
zypqIJ&1ofO*WCylV!VtTF-e)ID^#p*FCpLkLevmiCMITsrDx(s69N&%+8X@Zk46Ju
z5ru9#L|oL=YIN5x@TAClfuiYLrcYLrxylxq%T=jM2xwXFe)OuA5)qf_G$U{V<%quN
z4TE$XTi=_9=D#dD*sroI;o1J!wk~CprR7|l*2>wDW%ypS39d?H
z7v{FD6I62L^N-0~UpZ0&fnuhsSxB@yUKVw|CC{}pj(#DrZjO3}luAE0jkWBmu7u1#sRhMOZm3wDALyqUCi}r@^C#zej=^(s|IX8Q
z_ER2r27LTLtn|)k5O%i8$<%$FCq}W51|2#Zb36e{;vBQM@OSuw+QlVrW*^mc?&*n+
zm>T2zVw2ErJ;v3VJC;nme*B0e?dTn(YHUDOL%CwP_;Z&F60Pvd&a4HY&!UdoGxh2X
zv3x>&=Z6?)E48Zodq1>$P?KCAdlYD9dfx-~<#26qmb~=K^3saQkHjZQMn5!m4{&w_
z_gf+Z>P(7eY^M7dc=0Ai&5@1t-b_H@=ajN9(Co5#VsZH__6Mw`-dN9{1xP#*oIl^+{BC-5)~(tccTsK4OKYq
z6jou8TgvbkRF!~P2$~A$9Bwt6t<}jeh=*1JwB6j7w$M;#oLrIa-d=^qUS^lM7hPRlui>S9&QC&$E@RpQ
zyv@7gY7g|!u$Ca7tulce=cU2D41I6c;T@?c;kEb~>a-E`ZW+l69NqFACz
z*-hAU)ak2U7hg|y4f46i%}Q00a5s1vX=zotTw_4)_b;zI7cT1Opvs!S_XZjg#QTcl
z?H-a-ToGgLS9$oPCBZd2b0}%E57TWILiui=zjH}(vz}vM!KNTvxlO2Q|yGq9w4nh%tbwGl1N8z0ts7FtGdegb6LUn)+?ICQ~
zT;qL7EUtZ$Ic^{w7nxOCx^k)V#Tv{O$JvOFJrE%EEuaLuit-WV&cqYbaSJ&oLr}96
z)LF8eJF*Q;)-jG9P+2}g=F0^Xb>(2P^8S)@`-^e0Ef%V7Qe@L4b;!xMUyytUcWgp$
zg~q$%Ns^#P5LnJPOIt=ZbL%>EX-~ECjnBC^7fu{S)((LeJUk_*LPWO06S+qw9hJtT
za_i&S^wANrTQt6H-J@d