- 
-
-
-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.
-
-## 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 5b3c41c3bc..0000000000
--- 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 b4e809642a..0000000000
--- 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
+ ## Í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/changelog.mdx b/es/changelog.mdx
index ba3a2b6143..02fb893cd2 100644
--- a/es/changelog.mdx
+++ b/es/changelog.mdx
@@ -11,7 +11,7 @@ noindex: true
## Editor y colaboración
- - **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
@@ -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/commands.mdx b/es/cli/commands.mdx
index fb7ffb0f29..7c9f64e79e 100644
--- a/es/cli/commands.mdx
+++ b/es/cli/commands.mdx
@@ -368,6 +368,10 @@ mint automations delete
+ ### 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
@@ -80,5 +86,6 @@ https://mcp.mintlify.com
- [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 3e8609fc77..73737d4308 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
```
-
- ## Formato
+
-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.
+ ## 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 0000000000..cd1128c27c
--- /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 d8dd74d91d..33f5481e56 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.
+
+
- - `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/deploy/authentication-setup.mdx b/es/deploy/authentication-setup.mdx
index b88460193f..146c884bb6 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/deploy/reverse-proxy.mdx b/es/deploy/reverse-proxy.mdx
index feb262efc1..42ce33171b 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.
-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.`
@@ -162,7 +154,7 @@ Por ejemplo: `The new section on rate limits is too long. Trim it to three sente
+ ## 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/create/list-table.mdx b/es/create/list-table.mdx
index 31e5d5c9be..5e9eddb454 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 4639a0ee12..3dcabe6146 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.
@@ -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.
-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`
@@ -150,9 +142,9 @@ Ejemplos de prompts que usan code mode:
@@ -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`.
+
-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. 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.
+ ### 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/es/editor/agent.mdx b/es/editor/agent.mdx
index aa051225f7..499a55ee14 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
@@ -57,26 +49,26 @@ Tamaño máximo: 5 MB por archivo. Máximo: 10 archivos por mensaje.
-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.
-## 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.
@@ -84,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
@@ -98,7 +90,7 @@ A medida que el agente edita sus páginas, aparece un panel **Changed files** en
@@ -170,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 e1d097d1f8..0000000000
--- 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 0000000000..d2bea2e0b9
--- /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 a28f6b4fd5..0000000000
--- a/es/editor/comments.mdx
+++ /dev/null
@@ -1,92 +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.
-
-
- ## 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 3d302ee135..0000000000
--- 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 4f168d6e2e..0000000000
--- 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 398c0b728e..21b1e65863 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 8c52e6493e..0000000000
--- 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 090a82afdd..0000000000
--- 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 b98f313b75..0000000000
--- 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 1887f52d8a..c5e0c9be91 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 a1b920f926..0d0cbf40b8 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 0000000000..633ab1d093
--- /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 aa386d9c2f..58a15306ac 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.
- [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 f222aae2a0..6c4c4469a0 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.
+
- [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 f23bd28ac8..56d298e9ca 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
```
-
-
-### 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.
-
- 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/reference/concepts.mdx b/es/reference/concepts.mdx
index 5f822aeffb..6cc9c2d275 100644
--- a/es/reference/concepts.mdx
+++ b/es/reference/concepts.mdx
@@ -71,7 +71,7 @@ En el editor, los cambios se **guardan** automáticamente, pero no actualizan de
- Un **despliegue de vista previa** renderiza una solicitud de extracción en una URL temporal para que los revisores puedan inspeccionar el resultado antes de fusionarla.
- Fusionar una solicitud de extracción en la rama de despliegue activa un despliegue de producción.
-Consulta [Ramas y publicación](/es/editor/branching-and-publishing) para conocer el flujo de trabajo completo.
+Consulta [Ramas y publicación](/es/editor/publish) para conocer el flujo de trabajo completo.
` 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.
-## 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 dd532d06a7..0000000000
--- 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.
-
-
-
-
-
-
-
-
+ Si te quedas atascado, contacta a tu ejecutivo de cuenta (AE, account executive) o a tu ingeniero de soluciones (SE, solutions engineer), o escribe a [support@mintlify.com](mailto:support@mintlify.com).
+
+
+
+ Un propietario de la organización de GitHub o un administrador del repositorio debe aprobar la aplicación de GitHub de Mintlify antes de que tu sitio pueda desplegarse.
+
+
+
+
+ Ve a [mintlify.com/start](https://mintlify.com/start) y regístrate con tu correo electrónico de trabajo.
+
+
+
+ Conecta GitHub durante la configuración inicial. Crea un repositorio o selecciona uno vacío en la organización de tu empresa. Un repositorio privado llamado `docs` es una opción habitual.
+
+ No selecciones un repositorio que contenga código de aplicación o archivos no relacionados.
+
+
+
+ Pide a tu administrador de GitHub que instale la aplicación de GitHub de Mintlify. Concede acceso al repositorio de documentación seleccionando **Only select repositories**.
+
+ Consulta [Instalar la aplicación de GitHub](/es/deploy/github#install-the-github-app) para ver los permisos solicitados.
+
+
+ Si no puedes aprobar la aplicación, envía la solicitud de instalación. GitHub notifica a los propietarios de tu organización.
+
+ Para continuar mientras la aprobación está pendiente, omite el proveedor de Git durante la configuración inicial. Mintlify crea un repositorio privado que puedes mover más tarde desde [Git settings](https://app.mintlify.com/settings/deployment/git-settings). Consulta [Clonar en tu propio repositorio](/es/deploy/github#clone-to-your-own-repository).
+
+
+
+
+ Después de que el contenido inicial se despliegue, encuentra tu URL en la página **Overview** del [dashboard](https://app.mintlify.com/). Abre la URL `https://.mintlify.site` y confirma que carga.
+
+
+
+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`.
+
+
+
+ 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.
+ - Tu archivo o URL de OpenAPI, si aplica.
+ - Tus recursos de marca.
+
+ Consulta [Migraciones empresariales](/es/migration-services/enterprise) para ver el proceso de migración completo.
+
+
+
+ Usa uno de estos métodos:
+
+ 1. Exporta Markdown desde tu plataforma actual. Sigue la guía de migración para [Docusaurus](/es/migration/docusaurus), [ReadMe](/es/migration/readme), [GitBook](/es/migration/gitbook), [Fern](/es/migration/fern) o [Document360](/es/migration/document360).
+ 2. Pega un número reducido de páginas en el editor web y limpia el formato.
+ 3. Convierte el contenido con una herramienta de IA usando la [skill](/es/ai/skillmd) y el [servidor MCP de administración](/es/ai/mintlify-mcp) de Mintlify.
+
+ Consulta [Migrar a Mintlify](/es/migration) para otras plataformas.
+
+
+
+ Si tu contenido de origen está en Notion, Confluence, Jira o una herramienta similar, conéctalo al agente de Mintlify. Consulta [Integraciones para el agente y las automatizaciones](/es/automations/integrations).
+
+
+
+
+
+ Abre el [editor web](https://app.mintlify.com/editor). Selecciona el menú desplegable **Live site**, abre la pestaña **Branches** y selecciona **New branch**.
+
+ Una rama mantiene el borrador separado de tu sitio desplegado.
+
+
+
+ Edita la página en el editor visual. Escribe `/` para insertar un componente o arrastra una imagen a la página para subirla.
+
+ Usa el icono del ojo para previsualizar la página renderizada y el icono `` para ver su código fuente MDX.
+
+
+
+ Copia la URL de vista previa de la rama y envíala a un revisor. Haz los cambios solicitados en la misma rama.
+
+
+
+ Selecciona **Publish**. Publicar desde una rama abre o actualiza un pull request. Publicar desde **Live site** despliega el cambio de inmediato.
+
+ Confirma que la confirmación (commit) aparece en la página **Overview** del dashboard y que el cambio aprobado aparece en tu sitio.
+
+
+
+
+
+ Los cambios del editor crean confirmaciones (commits) de Git, por lo que CODEOWNERS, las revisiones obligatorias y la protección de ramas siguen aplicándose.
+
+
+
+ Los redactores pueden quedarse en la vista de Markdown del editor. Los ingenieros pueden instalar la [CLI](/es/cli/install), clonar el repositorio y ejecutar [`mint dev`](/es/cli/preview) localmente.
+
+
+
+También puedes probar los [despliegues de vista previa](/es/deploy/preview-deployments) para pull requests o [agregar el agente a Slack](/es/agent/slack#connect-your-slack-workspace) para proponer cambios de documentación desde Slack.
+
+
+
+ Agrega el [widget del asistente](/es/assistant/widget) a tu producto, sitio de marketing o portal de soporte.
+
+
+
+ Usa el [servidor MCP de búsqueda](/es/ai/model-context-protocol) para que el contenido publicado esté disponible en las herramientas de IA compatibles. Usa el [servidor MCP de administración](/es/ai/mintlify-mcp) para redactar y editar documentación.
+
+ También puedes probar el [menú contextual](/es/ai/contextual-menu), [`llms.txt`](/es/ai/llmstxt), [`skill.md`](/es/ai/skillmd) y la [exportación de páginas en Markdown](/es/ai/markdown-export).
+
+
+
+ Habilita una [automatización](/es/automations), como redactar un changelog o actualizar la documentación después de un cambio en el código. Comienza con **Require review** y luego inspecciona su pull request propuesto y el historial de ejecuciones. Consulta [Administrar automatizaciones](/es/automations/manage).
+
+
+
+
+ Revisa todo lo que debes configurar y verificar antes del lanzamiento.
+
diff --git a/es/quickstart.mdx b/es/quickstart.mdx
index 2aca780bf4..fa98d5ee8e 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
-## 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
+ ## 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 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 el DNS para un dominio personalizado, si pruebas la autenticación. | 1 a 2 horas |
+
+
+ ### 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 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:
+
+- 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 AE o SE.
+
+
+ ## 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 AE o SE 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 AE o SE.
+
+
+ ## 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 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. |
+
+Resuelve las preguntas pendientes con tu AE o SE 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 | 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
+
+
+
## Un build convierte los archivos fuente en experiencias para el lector
diff --git a/es/reference/glossary.mdx b/es/reference/glossary.mdx
index 1e3e1cb809..e1b8e76fbb 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/es/search-index/mcp.mdx b/es/search-index/mcp.mdx
index e3b819be5f..c6754dbb04 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.json b/fr.json
index ad77c4d160..0e057102e8 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/ai/llmstxt.mdx b/fr/ai/llmstxt.mdx
index 0b904befc3..a5f9130c0c 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.
-
- 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 9f9055a576..c0fb73ccd8 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`.
+
- - **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
+ ## 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/changelog.mdx b/fr/changelog.mdx
index 4d075ee684..438be6587a 100644
--- a/fr/changelog.mdx
+++ b/fr/changelog.mdx
@@ -11,7 +11,7 @@ noindex: true
## Éditeur et collaboration
@@ -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/commands.mdx b/fr/cli/commands.mdx
index 3cb771f2ea..4389a171ae 100644
--- a/fr/cli/commands.mdx
+++ b/fr/cli/commands.mdx
@@ -370,6 +370,10 @@ mint automations delete
+ ### 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
@@ -80,5 +86,6 @@ https://mcp.mintlify.com
- ## Formatage
+
+ ## 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 0000000000..d82167b108
--- /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 ec63f517f4..827cdd65df 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.
+
+
- - `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/deploy/authentication-setup.mdx b/fr/deploy/authentication-setup.mdx
index e4d6aff5a6..d5bb44f69f 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/deploy/reverse-proxy.mdx b/fr/deploy/reverse-proxy.mdx
index ed1a061a5e..4a150650ed 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.
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 ceee4d9b26..e45150e9b6 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.
+
-
+ ## 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/create/list-table.mdx b/fr/create/list-table.mdx
index 6aabb01afa..0b99b033e7 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 aacd79a6b4..a0ea1393ac 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.
@@ -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.
-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é.
@@ -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.
+
-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.`
@@ -162,7 +154,7 @@ Par exemple : `The new section on rate limits is too long. Trim it to three sent
+ ### 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/fr/editor/agent.mdx b/fr/editor/agent.mdx
index e9b93d3c5a..6a501867f1 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. 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 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
@@ -57,7 +49,7 @@ Taille maximale : 5 Mo par fichier. Maximum : 10 fichiers par message.
-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.
@@ -65,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.
@@ -98,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`
@@ -150,9 +142,9 @@ Exemples de prompts qui utilisent le mode code :
@@ -170,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 dd8af331d7..0000000000
--- 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 0000000000..442fc80360
--- /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 fe2da9c16f..0000000000
--- a/fr/editor/comments.mdx
+++ /dev/null
@@ -1,92 +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.
-
-
- ## 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 97b69c9318..0000000000
--- 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 96b5a746a8..0000000000
--- 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 346163ce21..d2d4112143 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 a411f6d9a3..0000000000
--- 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 c99fd6d089..0000000000
--- 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 aaf1fd07f8..0000000000
--- 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 cecfa47dde..b8c57fd68d 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 fa0d36e41f..a6ef574dee 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 0000000000..f5ec6f12a0
--- /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 c02a1a051b..aa744d600a 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.
- [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 fa5b7a0bc0..e596f08cd3 100644
--- a/zh/cli/index.mdx
+++ b/zh/cli/index.mdx
@@ -51,6 +51,12 @@ CLI 在你的本地机器上运行，在需要实时数据时连接到你的 Min
运行 `mint format` 将项目中的 MDX 文件重写为 Mintlify 的规范样式。该命令会遍历所有子目录，并就地重新格式化文件。
+
- [安装 CLI](/zh/cli/install)：安装并准备好 CLI。
+- [Mintlify MDX 扩展](/zh/cli/mdx-extension)：添加自动补全、内联错误检查和编辑器内预览。
- [本地预览](/zh/cli/preview)：运行支持搜索和助手的本地开发服务器。
- [命令参考](/zh/cli/commands)：所有命令和选项的完整参考。
diff --git a/zh/cli/install.mdx b/zh/cli/install.mdx
index 22f65116bc..deda9bd1e8 100644
--- a/zh/cli/install.mdx
+++ b/zh/cli/install.mdx
@@ -121,14 +121,16 @@ mint update
```
-
-### 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.
-
- 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/reference/concepts.mdx b/fr/reference/concepts.mdx
index c6a38d8b3d..245449f70e 100644
--- a/fr/reference/concepts.mdx
+++ b/fr/reference/concepts.mdx
@@ -71,7 +71,7 @@ Dans l'éditeur, les modifications sont **enregistrées** automatiquement mais n
- Un **déploiement de prévisualisation** rend une pull request sur une URL temporaire afin que les relecteurs puissent inspecter le résultat avant la fusion.
- La fusion d'une pull request dans la branche de déploiement déclenche un déploiement en production.
-Consultez [Branching et publication](/fr/editor/branching-and-publishing) pour le workflow complet.
+Consultez [Branching et publication](/fr/editor/publish) pour le workflow complet.
` 名称。详情请参见 [Branching and publishing](/zh/editor/branching-and-publishing)。
+ - **Branches v2 与版本历史：** 编辑器分支现在以草稿 pull request 为基础，并自动将更改保存到 Git。您可以重命名或删除分支、丢弃自动保存的更改，以及将待处理更改移动到新分支。分支菜单按最近活动排序、使用按用户区分的分支名称，并为自动生成的分支显示更简洁的 `Draft ` 名称。详情请参见 [Branching and publishing](/zh/editor/publish)。
- **简化的编辑器导航：** 编辑器新增面包屑行，整合了页面和分享控件，增加了固定的侧边栏分区标题，以及用于设置和 **Ask agent** 的专用底栏。在小屏幕上，移动端导航现在使用简化的顶栏和面板式侧边栏。
- **页面访问与评论：** 您可以直接在编辑器中请求对私密或受保护页面的编辑权限，并在审批弹窗中处理请求。评论卡片现在会显示头像，@提及也会链接到被提及的用户。
- **实时预览改进：** 可同时运行多个本地预览。导航更改会同步到已打开的预览，Agent 面板停靠在左侧，并且预览会在 onboarding 后续步骤中保持可见。
@@ -179,7 +179,7 @@ noindex: true
- **评审流程：** 在草稿上发起评审、留下反馈，并在发布前批准或请求修改。评审现已支持非部署分支。
- - **更多协作方式：** 在整个页面上发起[评论线程](/zh/editor/comments)、提及自己以留下提醒，并使用键盘快捷键 Option + C 或 Option + S 对所选文本发表评论或提出修改建议。
+ - **更多协作方式：** 在整个页面上发起[评论线程](/zh/editor/collaborate#comments)、提及自己以留下提醒，并使用键盘快捷键 Option + C 或 Option + S 对所选文本发表评论或提出修改建议。
- **更快、更易用的编辑体验：** 编辑器无需等待 Git 文件树即可渲染，没有 GitHub 写入权限的用户也可以使用编辑器。
-## 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 6c73a7604a..0000000000
--- 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.
-
-
-
-
-
-
-
-
+ 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).
+
+
+
+ Un propriétaire de l'organisation GitHub ou un administrateur du dépôt doit approuver la GitHub App Mintlify avant que votre site puisse être déployé.
+
+
+
+
+ Accédez à [mintlify.com/start](https://mintlify.com/start) et inscrivez-vous avec votre adresse e-mail professionnelle.
+
+
+
+ Connectez GitHub pendant l'onboarding. Créez un dépôt ou sélectionnez un dépôt vide dans l'organisation de votre entreprise. Un dépôt privé nommé `docs` est un choix courant.
+
+ Ne sélectionnez pas un dépôt qui contient du code applicatif ou des fichiers sans rapport avec la documentation.
+
+
+
+ Demandez à votre administrateur GitHub d'installer la GitHub App Mintlify. Accordez l'accès au dépôt de documentation en sélectionnant **Only select repositories**.
+
+ Consultez [Installer la GitHub App](/fr/deploy/github#install-the-github-app) pour connaître les autorisations demandées.
+
+
+ Si vous ne pouvez pas approuver l'application, soumettez la demande d'installation. GitHub notifie les propriétaires de votre organisation.
+
+ Pour continuer en attendant l'approbation, ignorez le fournisseur Git pendant l'onboarding. Mintlify crée un dépôt privé que vous pourrez déplacer plus tard depuis les [paramètres Git](https://app.mintlify.com/settings/deployment/git-settings). Consultez [Cloner dans votre propre dépôt](/fr/deploy/github#clone-to-your-own-repository).
+
+
+
+
+ Une fois le contenu de démarrage déployé, trouvez votre URL sur la page **Overview** du [tableau de bord](https://app.mintlify.com/). Ouvrez l'URL `https://.mintlify.site` et confirmez qu'elle se charge.
+
+
+
+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`.
+
+
+
+ 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.
+ - Votre fichier ou URL OpenAPI, le cas échéant.
+ - Vos éléments de marque.
+
+ Consultez [Migrations entreprise](/fr/migration-services/enterprise) pour le processus de migration complet.
+
+
+
+ Utilisez l'une de ces méthodes :
+
+ 1. Exportez du Markdown depuis votre plateforme actuelle. Suivez le guide de migration pour [Docusaurus](/fr/migration/docusaurus), [ReadMe](/fr/migration/readme), [GitBook](/fr/migration/gitbook), [Fern](/fr/migration/fern) ou [Document360](/fr/migration/document360).
+ 2. Collez un petit nombre de pages dans l'éditeur web et nettoyez la mise en forme.
+ 3. Convertissez le contenu avec un outil d'IA en utilisant la [skill](/fr/ai/skillmd) Mintlify et le [serveur MCP d'administration](/fr/ai/mintlify-mcp).
+
+ Consultez [Migrer vers Mintlify](/fr/migration) pour les autres plateformes.
+
+
+
+ Si votre contenu source se trouve dans Notion, Confluence, Jira ou un outil similaire, connectez-le à l'agent Mintlify. Consultez [Intégrations pour l'agent et les automatisations](/fr/automations/integrations).
+
+
+
+
+
+ Ouvrez l'[éditeur web](https://app.mintlify.com/editor). Sélectionnez le menu déroulant **Live site**, ouvrez l'onglet **Branches**, puis sélectionnez **New branch**.
+
+ Une branche garde le brouillon séparé de votre site déployé.
+
+
+
+ Modifiez la page dans l'éditeur visuel. Tapez `/` pour insérer un composant ou faites glisser une image sur la page pour la téléverser.
+
+ Utilisez l'icône en forme d'œil pour prévisualiser la page rendue et l'icône `` pour afficher sa source MDX.
+
+
+
+ Copiez l'URL d'aperçu de la branche et envoyez-la à un relecteur. Apportez les modifications demandées sur la même branche.
+
+
+
+ Sélectionnez **Publish**. Publier depuis une branche ouvre ou met à jour une pull request. Publier depuis **Live site** déploie la modification immédiatement.
+
+ Confirmez que le commit apparaît sur la page **Overview** du tableau de bord et que la modification approuvée apparaît sur votre site.
+
+
+
+
+
+ Les modifications faites dans l'éditeur créent des commits Git ; CODEOWNERS, les revues obligatoires et la protection des branches continuent donc de s'appliquer.
+
+
+
+ Les rédacteurs peuvent rester dans la vue Markdown de l'éditeur. Les ingénieurs peuvent installer la [CLI](/fr/cli/install), cloner le dépôt et exécuter [`mint dev`](/fr/cli/preview) en local.
+
+
+
+Vous pouvez aussi tester les [déploiements d'aperçu](/fr/deploy/preview-deployments) pour les pull requests ou [ajouter l'agent à Slack](/fr/agent/slack#connect-your-slack-workspace) pour proposer des modifications de documentation depuis Slack.
+
+
+
+ Ajoutez le [widget de l'assistant](/fr/assistant/widget) à votre produit, à votre site marketing ou à votre portail d'assistance.
+
+
+
+ Utilisez le [serveur MCP de recherche](/fr/ai/model-context-protocol) pour rendre le contenu publié disponible dans les outils d'IA pris en charge. Utilisez le [serveur MCP d'administration](/fr/ai/mintlify-mcp) pour rédiger et modifier la documentation.
+
+ Vous pouvez aussi tester le [menu contextuel](/fr/ai/contextual-menu), [`llms.txt`](/fr/ai/llmstxt), [`skill.md`](/fr/ai/skillmd) et l'[export des pages en Markdown](/fr/ai/markdown-export).
+
+
+
+ Activez une [automatisation](/fr/automations), comme la rédaction d'un changelog ou la mise à jour de la documentation après une modification du code. Commencez avec **Require review**, puis examinez la pull request proposée et l'historique des exécutions. Consultez [Gérer les automatisations](/fr/automations/manage).
+
+
+
+
+ Passez en revue tout ce qu'il faut configurer et vérifier avant le lancement.
+
diff --git a/fr/quickstart.mdx b/fr/quickstart.mdx
index abf1d52cb8..85462876ac 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
-## 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
+ ## 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 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 le DNS pour un domaine personnalisé, si vous testez l'authentification. | 1 à 2 heures |
+
+
+ ### 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 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 :
+
+- 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 AE ou SE.
+
+
+ ## É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 AE ou SE 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 AE ou SE.
+
+
+ ## É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 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. |
+
+Résolvez les questions en suspens avec votre AE ou SE 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 | 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
+
+
+
## 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 29bc9984dd..4214fc3519 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/fr/search-index/mcp.mdx b/fr/search-index/mcp.mdx
index 9740e34b4c..b3b21e69a4 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/images/editor/editor-layout-dark.png b/images/editor/editor-layout-dark.png
deleted file mode 100644
index 101c433099..0000000000
Binary files a/images/editor/editor-layout-dark.png and /dev/null differ
diff --git a/images/editor/editor-layout-light.png b/images/editor/editor-layout-light.png
deleted file mode 100644
index a13dd4373a..0000000000
Binary files a/images/editor/editor-layout-light.png and /dev/null differ
diff --git a/images/editor/layout-dark.png b/images/editor/layout-dark.png
new file mode 100644
index 0000000000..64f6ef9769
Binary files /dev/null and b/images/editor/layout-dark.png differ
diff --git a/images/editor/layout-light.png b/images/editor/layout-light.png
new file mode 100644
index 0000000000..e1122416ec
Binary files /dev/null and b/images/editor/layout-light.png differ
diff --git a/images/editor/live-preview-dark.png b/images/editor/live-preview-dark.png
deleted file mode 100644
index 0194668632..0000000000
Binary files a/images/editor/live-preview-dark.png and /dev/null differ
diff --git a/images/editor/live-preview-light.png b/images/editor/live-preview-light.png
deleted file mode 100644
index ee314351ce..0000000000
Binary files a/images/editor/live-preview-light.png and /dev/null differ
diff --git a/images/editor/preview-url-dark.png b/images/editor/preview-url-dark.png
deleted file mode 100644
index e995bd89f6..0000000000
Binary files a/images/editor/preview-url-dark.png and /dev/null differ
diff --git a/images/editor/preview-url-light.png b/images/editor/preview-url-light.png
deleted file mode 100644
index fc78fafea7..0000000000
Binary files a/images/editor/preview-url-light.png and /dev/null differ
diff --git a/migration/fern.mdx b/migration/fern.mdx
index 0a6931aad3..0d82dd029c 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 b36308afb3..0c4167e92a 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 af110996dc..793d2c5f77 100644
--- a/poc-onboarding.mdx
+++ b/poc-onboarding.mdx
@@ -8,7 +8,7 @@ noindex: true
Use this guide to set up a working documentation site and evaluate Mintlify with your team. Most tasks happen in the dashboard, but you need brief help from GitHub and IT administrators for some steps.
- If you get stuck, contact your Mintlify representative in your shared Slack channel or email [support@mintlify.com](mailto:support@mintlify.com).
+ If you get stuck, contact your account executive (AE) or solutions engineer (SE), or email [support@mintlify.com](mailto:support@mintlify.com).
## POC workflow
@@ -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,8 +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 |
-| Decision maker | Reviews the POC against your success criteria. | 1 hour |
+| Identity or IT administrator | Configures DNS for a custom domain, if you test authentication. | 1 to 2 hours |
### Gather your content and brand assets
@@ -54,10 +52,11 @@ Collect:
### Define success
-Choose one business goal and record its current baseline:
+Choose one of the value drivers that customers most commonly measure Mintlify against, then record its current baseline:
- **Acquisition:** Improve activation rate or time to first integration.
- **Deflection:** Reduce ticket volume for a common support topic.
+- **Engineering time saved:** Reduce the engineering hours spent writing, reviewing, and maintaining documentation.
- **Retention:** Increase adoption of a feature after launch.
Add two or three criteria that you can test during the POC. For example:
@@ -67,7 +66,7 @@ Add two or three criteria that you can test during the POC. For example:
- The assistant answers 8 of 10 common support questions and cites the correct pages.
- Your identity provider supports dashboard login.
-Share the goal, baseline, and criteria with your Mintlify representative.
+Share the goal, baseline, and criteria with your AE or SE.
## Step 1: Connect your repository
@@ -103,7 +102,7 @@ Share the goal, baseline, and criteria with your Mintlify representative.
-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 if you test authentication.
## Step 3: Add sample content
@@ -135,7 +134,7 @@ Keep the sample under 50 pages so you can focus on migration quality.
- Ask your Mintlify representative whether migration is included in your POC. If it is, send:
+ Ask your AE or SE whether migration is included in your POC. If it is, send:
- Your current documentation URL or export.
- Your list of sample pages.
@@ -169,7 +168,7 @@ Compare each sample page with its source. Check:
- Custom components and embeds.
- Navigation labels and page placement.
-Confirm that a new user can reach a useful page in two clicks and that navigation labels use terms readers are likely to search for. Send migration issues to your Mintlify representative in one list with the page URL and expected result.
+Confirm that a new user can reach a useful page in two clicks and that navigation labels use terms readers are likely to search for. Send migration issues to your AE or SE in one list with the page URL and expected result.
## Step 4: Publish a change
@@ -237,7 +236,7 @@ Then:
2. Add your fonts using the [font settings](/customize/fonts).
3. Add a default Open Graph image and test a shared link in Slack.
-See [Appearance settings](/organize/settings-appearance), [Themes](/customize/themes), and [SEO](/optimize/seo) for other options. If you do not want to edit `docs.json`, send your assets to your Mintlify representative.
+See [Appearance settings](/organize/settings-appearance), [Themes](/customize/themes), and [SEO](/optimize/seo) for other options. If you do not want to edit `docs.json`, send your assets to your AE or SE.
## Step 6: Test AI features
@@ -245,7 +244,7 @@ See [Appearance settings](/organize/settings-appearance), [Themes](/customize/th
Open the [Assistant](https://app.mintlify.com/products/assistant) page:
-1. Turn on the assistant.
+1. Enable the assistant.
2. Add [deflection email addresses](/assistant/configure#set-deflection-emails) for questions that need human help.
3. Add up to three [starter questions](/assistant/configure#add-sample-questions).
4. Add [search domains](/assistant/configure#search-domains) if relevant content spans multiple sites.
@@ -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,9 +294,8 @@ 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 Mintlify representative before this meeting.
+Resolve open questions with your AE or SE before this meeting.
## Suggested timeline
@@ -355,11 +305,11 @@ 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. |
-## Getting help
+## Get help
-- Use your shared Slack channel for time-sensitive POC questions.
+- 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.
diff --git a/quickstart.mdx b/quickstart.mdx
index 8fe1e05a5c..49eb0193c7 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/redirects.json b/redirects.json
index 5e32161ab9..2bb0fdc68c 100644
--- a/redirects.json
+++ b/redirects.json
@@ -1,19 +1,19 @@
[
{
"source": "/editor/drafts",
- "destination": "/editor/branching-and-publishing"
+ "destination": "/editor/publish"
},
{
"source": "/es/editor/drafts",
- "destination": "/es/editor/branching-and-publishing"
+ "destination": "/es/editor/publish"
},
{
"source": "/fr/editor/drafts",
- "destination": "/fr/editor/branching-and-publishing"
+ "destination": "/fr/editor/publish"
},
{
"source": "/zh/editor/drafts",
- "destination": "/zh/editor/branching-and-publishing"
+ "destination": "/zh/editor/publish"
},
{
"source": "/agent/integrations",
@@ -305,19 +305,19 @@
},
{
"source": "/editor/publishing",
- "destination": "/editor/branching-and-publishing"
+ "destination": "/editor/publish"
},
{
"source": "/es/editor/publishing",
- "destination": "/es/editor/branching-and-publishing"
+ "destination": "/es/editor/publish"
},
{
"source": "/fr/editor/publishing",
- "destination": "/fr/editor/branching-and-publishing"
+ "destination": "/fr/editor/publish"
},
{
"source": "/zh/editor/publishing",
- "destination": "/zh/editor/branching-and-publishing"
+ "destination": "/zh/editor/publish"
},
{
"source": "/editor/troubleshooting",
@@ -1287,14 +1287,6 @@
"source": "/settings/global",
"destination": "/organize/settings"
},
- {
- "source": "/editor/publish",
- "destination": "/editor/branching-and-publishing"
- },
- {
- "source": "/editor/media",
- "destination": "/editor/pages"
- },
{
"source": "/workflows/enable",
"destination": "/automations/manage"
@@ -1398,5 +1390,121 @@
{
"source": "/zh/dashboard/permissions",
"destination": "/zh/dashboard/roles#repository-contributors-and-deployments"
+ },
+ {
+ "source": "/editor/branching-and-publishing",
+ "destination": "/editor/publish"
+ },
+ {
+ "source": "/editor/git-essentials",
+ "destination": "/editor/index"
+ },
+ {
+ "source": "/editor/live-preview",
+ "destination": "/editor/review#live-preview"
+ },
+ {
+ "source": "/editor/comments",
+ "destination": "/editor/collaborate#comments"
+ },
+ {
+ "source": "/editor/suggestions",
+ "destination": "/editor/collaborate#suggestions"
+ },
+ {
+ "source": "/editor/configurations",
+ "destination": "/editor/settings"
+ },
+ {
+ "source": "/editor/navigation",
+ "destination": "/editor/pages#organize-navigation"
+ },
+ {
+ "source": "/editor/media",
+ "destination": "/editor/pages#add-media"
+ },
+ {
+ "source": "/es/editor/branching-and-publishing",
+ "destination": "/es/editor/publish"
+ },
+ {
+ "source": "/es/editor/git-essentials",
+ "destination": "/es/editor/index"
+ },
+ {
+ "source": "/es/editor/live-preview",
+ "destination": "/es/editor/review#live-preview"
+ },
+ {
+ "source": "/es/editor/comments",
+ "destination": "/es/editor/collaborate#comments"
+ },
+ {
+ "source": "/es/editor/suggestions",
+ "destination": "/es/editor/collaborate#suggestions"
+ },
+ {
+ "source": "/es/editor/configurations",
+ "destination": "/es/editor/settings"
+ },
+ {
+ "source": "/es/editor/navigation",
+ "destination": "/es/editor/pages#organize-navigation"
+ },
+ {
+ "source": "/fr/editor/branching-and-publishing",
+ "destination": "/fr/editor/publish"
+ },
+ {
+ "source": "/fr/editor/git-essentials",
+ "destination": "/fr/editor/index"
+ },
+ {
+ "source": "/fr/editor/live-preview",
+ "destination": "/fr/editor/review#live-preview"
+ },
+ {
+ "source": "/fr/editor/comments",
+ "destination": "/fr/editor/collaborate#comments"
+ },
+ {
+ "source": "/fr/editor/suggestions",
+ "destination": "/fr/editor/collaborate#suggestions"
+ },
+ {
+ "source": "/fr/editor/configurations",
+ "destination": "/fr/editor/settings"
+ },
+ {
+ "source": "/fr/editor/navigation",
+ "destination": "/fr/editor/pages#organize-navigation"
+ },
+ {
+ "source": "/zh/editor/branching-and-publishing",
+ "destination": "/zh/editor/publish"
+ },
+ {
+ "source": "/zh/editor/git-essentials",
+ "destination": "/zh/editor/index"
+ },
+ {
+ "source": "/zh/editor/live-preview",
+ "destination": "/zh/editor/review#live-preview"
+ },
+ {
+ "source": "/zh/editor/comments",
+ "destination": "/zh/editor/collaborate#comments"
+ },
+ {
+ "source": "/zh/editor/suggestions",
+ "destination": "/zh/editor/collaborate#suggestions"
+ },
+ {
+ "source": "/zh/editor/configurations",
+ "destination": "/zh/editor/settings"
+ },
+ {
+ "source": "/zh/editor/navigation",
+ "destination": "/zh/editor/pages#organize-navigation"
}
]
diff --git a/reference/concepts.mdx b/reference/concepts.mdx
index fb42e15f9b..64c02c6910 100644
--- a/reference/concepts.mdx
+++ b/reference/concepts.mdx
@@ -63,7 +63,7 @@ In the editor, changes **save** automatically but do not immediately update your
- A **preview deployment** renders a pull request at a temporary URL so reviewers can inspect the result before merging.
- Merging a pull request into the deployment branch triggers a production deployment.
-See [Branching and publishing](/editor/branching-and-publishing) for the complete workflow.
+See [Publish changes](/editor/publish) for the complete workflow.
## A build turns source files into reader experiences
diff --git a/reference/glossary.mdx b/reference/glossary.mdx
index b67c2ec8ae..dbd11911ea 100644
--- a/reference/glossary.mdx
+++ b/reference/glossary.mdx
@@ -126,7 +126,7 @@ A locale-specific version of your documentation configured in navigation. Langua
### Live preview
-The continuously updated rendering of your unpublished edits inside the web editor. A live preview is not publicly deployed. See [Live preview](/editor/live-preview).
+The continuously updated rendering of your unpublished edits inside the web editor. A live preview is not publicly deployed. See [Live preview](/editor/review#live-preview).
### Live site
diff --git a/search-index/mcp.mdx b/search-index/mcp.mdx
index 11f5972408..115d6c44d0 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 1de34e6d6a..92d431770c 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 d5da9e75c0..7aa35d8314 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 530840252e..9bbcd9668f 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 55312916b5..73fdaba642 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.json b/zh.json
index 4452e7efc3..4f737b4705 100644
--- a/zh.json
+++ b/zh.json
@@ -15,6 +15,7 @@
"root": "zh/cli/index",
"pages": [
"zh/cli/install",
+ "zh/cli/mdx-extension",
"zh/cli/preview",
"zh/cli/commands"
]
@@ -99,15 +100,11 @@
"root": "zh/editor/index",
"pages": [
"zh/editor/tutorial",
- "zh/editor/git-essentials",
"zh/editor/pages",
- "zh/editor/navigation",
- "zh/editor/live-preview",
- "zh/editor/branching-and-publishing",
- "zh/editor/comments",
- "zh/editor/suggestions",
+ "zh/editor/publish",
+ "zh/editor/review",
+ "zh/editor/collaborate",
"zh/editor/agent",
- "zh/editor/configurations",
"zh/editor/settings",
"zh/editor/keyboard-shortcuts"
]
diff --git a/zh/ai/llmstxt.mdx b/zh/ai/llmstxt.mdx
index 354db76cce..fe5f875ac4 100644
--- a/zh/ai/llmstxt.mdx
+++ b/zh/ai/llmstxt.mdx
@@ -57,11 +57,36 @@ X-Llms-Txt: /llms.txt
这种结构化方法使 LLM 能够高效地从宏观层面处理你的文档，并为用户查询定位相关内容，从而提升 AI 辅助文档搜索的准确性和速度。
-
- 自动生成的 `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 8c87f729be..e95775ccc9 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`。
+
- - **Branches v2 与版本历史：** 编辑器分支现在以草稿 pull request 为基础，并自动将更改保存到 Git。您可以重命名或删除分支、丢弃自动保存的更改，以及将待处理更改移动到新分支。分支菜单按最近活动排序、使用按用户区分的分支名称，并为自动生成的分支显示更简洁的 `Draft
+ ## `/_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/changelog.mdx b/zh/changelog.mdx
index 7df55b748d..5a178e2e04 100644
--- a/zh/changelog.mdx
+++ b/zh/changelog.mdx
@@ -11,7 +11,7 @@ noindex: true
## 编辑器与协作
@@ -236,7 +236,7 @@ noindex: true
## 编辑器改进
- - **草稿：** 无需创建分支或使用任何 Git 命令，即可处理未发布的更改。有关更多信息，请参阅[草稿](/zh/editor/branching-and-publishing)。
+ - **草稿：** 无需创建分支或使用任何 Git 命令，即可处理未发布的更改。有关更多信息，请参阅[草稿](/zh/editor/publish)。
- **锁定部署分支：** 如果检测到分支保护，编辑器现在会提示您锁定部署分支。
- **更快的[编辑器代理](/zh/editor)与更完善的撤销/重做：** 代理更新现在会即时流式显示，导航速度更快，内容和导航树更改也可以干净地撤销和重做。
- **可折叠标题状态按用户持久化：** 您展开和折叠章节的偏好会在多个编辑器会话之间保留。
@@ -1001,7 +1001,7 @@ noindex: true
- 重新设计了编辑器配置设置页面，改进了布局并支持自动保存。
- 从 OpenAPI 规范自动生成的页面现在以只读条目的形式显示在 Web 编辑器中。
- - [实时预览](/zh/editor/live-preview)中的视频支持。嵌入的 mp4、webm 和 mov 文件现在在本地开发期间可以正确渲染。
+ - [实时预览](/zh/editor/review#live-preview)中的视频支持。嵌入的 mp4、webm 和 mov 文件现在在本地开发期间可以正确渲染。
- [自动化](/zh/automations)现在可以从仪表板禁用和重新启用。
- 助手分析现在在仪表板中显示按来源（Web 与 API）分类的使用情况。
- 经过身份验证的 MCP 搜索现在可以根据用户的身份验证组正确过滤结果。
diff --git a/zh/cli/commands.mdx b/zh/cli/commands.mdx
index 5daa37d42b..11bc4d14cf 100644
--- a/zh/cli/commands.mdx
+++ b/zh/cli/commands.mdx
@@ -370,6 +370,10 @@ mint automations delete
+ ### 查询分析数据
+
+
+运行 `mint analytics` 从终端查看文档统计、搜索、反馈和助手会话。当 CLI 检测到 AI 或 CI 环境时，输出默认使用 JSON，方便 agent 将结果传给其他工具。
+
### 管理配置
@@ -80,5 +86,6 @@ https://mcp.mintlify.com
- ## 格式化
+
+ ## 编辑器支持
-对于 MDX 文件中的语法高亮和代码格式化，我们推荐使用以下扩展：
+对于 MDX 文件中的语法高亮、自动补全和错误检查，请使用以下扩展：
-- **Cursor、Devin Desktop、VS Code**：[MDX VS Code 扩展](https://marketplace.visualstudio.com/items?itemName=unifiedjs.vscode-mdx) 和 [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode)
-- **JetBrains**：[MDX IntelliJ IDEA 插件](https://plugins.jetbrains.com/plugin/14944-mdx) 和 [Prettier](https://prettier.io/docs/webstorm)
+- **Cursor、Devin Desktop、VS Code**：[Mintlify MDX 扩展](/zh/cli/mdx-extension) 和用于格式化的 [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode)。
+- **JetBrains**：[MDX IntelliJ IDEA 插件](https://plugins.jetbrains.com/plugin/14944-mdx) 和 [Prettier](https://prettier.io/docs/webstorm)。
+
+你也可以使用 [`mint format`](/zh/cli/commands#mint-format) 格式化 MDX 文件。
## 故障排除
diff --git a/zh/cli/mdx-extension.mdx b/zh/cli/mdx-extension.mdx
new file mode 100644
index 0000000000..d0766c44ab
--- /dev/null
+++ b/zh/cli/mdx-extension.mdx
@@ -0,0 +1,169 @@
+---
+title: "Mintlify MDX 扩展"
+description: "安装 Mintlify MDX 扩展，在本地编写 MDX 时获得自动补全、内联诊断、悬停文档和编辑器内预览。"
+keywords: ["Cursor", "MDX", "自动补全", "诊断", "IntelliSense", "预览", "编辑器"]
+---
+
+Mintlify MDX 扩展为 VS Code、Cursor、Devin Desktop 以及其他支持 VS Code 扩展 API 的编辑器提供 Mintlify 项目的语言支持。该扩展了解每个内置组件和属性，因此你在输入时可以获得自动补全，它还会报告未知组件、无效属性和无法解析的 snippet 导入。
+
+该扩展还会在编辑器内运行实时预览，让你无需切换到浏览器即可边写作边查看渲染结果。
+
+
+ 编写单个页面时使用编辑器内预览；当你想在整个站点范围内测试导航、搜索或身份验证时，在浏览器中使用 [`mint dev`](/zh/cli/preview)。
+
+
+
+
+ 扩展相对于文档根目录解析组件。运行 **Mintlify: Show detected docs root**，确认它找到了正确的 `docs.json` 文件。如果根目录错误或缺失，请将包含 `docs.json` 文件的文件夹作为工作区打开。
+
+ 如果根目录正确，请运行 **Mintlify: Restart language server**。
+
+
+ 很可能有另一个 MDX 扩展也处于激活状态。打开扩展视图，搜索 `mdx`，并在此工作区中禁用其他所有 MDX 扩展。
+
+
+ 打开 **Mintlify Preview** 输出通道，查看 `mint dev` 的错误信息。
+
+ - `could not run "mint dev --no-open"`：CLI 未安装。使用 `npm i -g mint` 安装。
+ - `Trust the workspace first`：通过 **Manage Workspace Trust** 信任该工作区。
+ - `no docs.json found above this file`：将包含 `docs.json` 文件的文件夹作为工作区打开。
+ - `Invalid docs.json`：运行 [`mint validate`](/zh/cli/commands#mint-validate) 查找配置错误。
+
+
+ 绝对导入路径从文档根目录解析，而不是从当前文件解析。请确认该路径与 snippet 文件相对于 `docs.json` 文件的位置一致，并且检测到的根目录是正确的。
+
+
diff --git a/zh/cli/preview.mdx b/zh/cli/preview.mdx
index 6f4577e773..bd671033ab 100644
--- a/zh/cli/preview.mdx
+++ b/zh/cli/preview.mdx
@@ -35,6 +35,10 @@ mint dev --no-open
npx mint dev
```
+
+ 如果你在 VS Code 或 Cursor 中写作，[Mintlify MDX 扩展](/zh/cli/mdx-extension)会在编辑器旁的面板中运行此预览，并滚动到与你正在编辑的页面相匹配的位置。
+
+
- - `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/deploy/authentication-setup.mdx b/zh/deploy/authentication-setup.mdx
index a36383b431..5be39efe7e 100644
--- a/zh/deploy/authentication-setup.mdx
+++ b/zh/deploy/authentication-setup.mdx
@@ -581,4 +581,4 @@ groups: ["admin"]
| [skill.md](/zh/ai/skillmd) | 完全支持 | 不支持 | 不支持 |
| [站点地图](/zh/optimize/seo#sitemaps-and-robotstxt-files) | 完全支持 | 需要通过认证后才能访问，但会排除 groups 中的页面 | 需要通过认证后才能访问，但会排除 groups 中的页面 |
| [robots.txt](/zh/optimize/seo#sitemaps-and-robotstxt-files) | 完全支持 | 需要通过认证后才能访问 | 需要通过认证后才能访问 |
-| [实时预览](/zh/editor/live-preview) | 完全支持 | 支持编辑器自动认证 | 支持编辑器自动认证 |
+| [实时预览](/zh/editor/review#live-preview) | 完全支持 | 支持编辑器自动认证 | 支持编辑器自动认证 |
diff --git a/zh/deploy/reverse-proxy.mdx b/zh/deploy/reverse-proxy.mdx
index 86a7693c95..cb5e7e5ddf 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` 作为代理目标。
+ ## 前提条件
+
+
+- VS Code 1.85.0 或更高版本
+- 包含有效 `docs.json` 文件的文档目录
+- [Mintlify CLI](/zh/cli/install)（仅编辑器内预览需要）
+
+
+ ## 安装扩展
+
+
+从命令行安装：
+
+```bash
+code --install-extension mintlify.mintlify-snippets
+```
+
+或在编辑器内安装：
+
+1. 打开扩展视图。
+2. 搜索 `@id:mintlify.mintlify-snippets`。
+3. 点击 **Install**。
+
+你也可以从 [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=mintlify.mintlify-snippets) 安装。
+
+当你打开 `.mdx` 文件或包含 `docs.json` 文件的工作区时，扩展会自动激活。
+
+
+ ## 自动补全
+
+
+输入 `<` 即可查看所有内置组件。自动补全会在标签内提示组件的属性和值。
+
+除内置组件外，扩展还会提示你从[可复用 snippet](/zh/create/reusable-snippets) 导入的组件。
+
+
+ ## 诊断
+
+
+扩展会在“问题”面板中报告问题，并在你编写时在文件中以下划线标出：
+
+- 未知组件。
+- 未知或重复的属性。
+- 枚举属性的无效值。
+- 缺少必需属性。
+- 未闭合或不匹配的标签。
+- 无法解析的 snippet 导入。
+
+这些类型的错误会导致构建失败，因此请在编写时及时修复，以避免部署失败。
+
+要关闭诊断，请将 `mintlify.diagnostics.enabled` 设置为 `false`。
+
+
+ ## 悬停文档
+
+
+将光标悬停在组件或属性上，即可查看其作用以及指向 Mintlify 文档中对应页面的链接。悬停在 snippet 组件上会预览 snippet 文件的内容。
+
+
+ ## 跳转到定义
+
+
+按住 CMD（macOS）或 CTRL（Windows）并点击，即可跳转到以下内容的定义：
+
+- Snippet 组件。
+- 导入路径。
+- 指向本地页面的 `href` 和 `src` 属性。
+
+扩展会从打开的文件向上查找，直到找到 `docs.json`，以此确定文档根目录，因此像 `/snippets/example.mdx` 这样的绝对导入可以正确解析。检测到的项目会显示在状态栏中。要查看扩展正在使用哪个根目录，请在命令面板中运行 **Mintlify: Show detected docs root**。
+
+
+ ## 配置校验
+
+
+扩展会根据 [Mintlify 架构](https://mintlify.com/docs.json)校验 `docs.json`。
+
+
+ ## 在编辑器中预览
+
+
+打开一个 `.mdx` 文件，选择编辑器标题栏中的预览图标，或右键点击文件并选择 **Preview Mintlify**。预览面板会在编辑器旁打开并渲染页面。
+
+编辑器内预览需要 [Mintlify CLI](/zh/cli/install)。运行中服务器的 URL 会显示在状态栏中。选择它可以停止服务器，或运行 **Mintlify: Stop preview server**。
+
+要查看底层 `mint dev` 进程的输出，请打开 **Mintlify Preview** 输出通道。
+
+
+ ## 用组件包裹内容
+
+
+扩展包含的 snippet 会将选中的文本包裹在组件中，而不是插入一个空组件让你填写。
+
+使用方法：选中要包裹的内容，然后在命令面板中运行 **Snippets: Surround With** 并选择一个组件。可用的 snippet 包括 `AccordionGroup`、`CardGroup`、`CodeGroup`、`Expandable`、`Frame`、`RequestExample`、`ResponseExample` 和围栏代码块。
+
+
+ ## 设置
+
+
+| 设置 | 默认值 | 说明 |
+| --- | --- | --- |
+| `mintlify.diagnostics.enabled` | `true` | 报告未知组件、未知属性、缺少的必需属性和无法解析的 snippet 导入。 |
+| `mintlify.warnAboutConflictingExtensions` | `true` | 当你在 Mintlify MDX 扩展之外还安装了其他 MDX 扩展时发出警告。 |
+| `mintlify.preview.command` | `mint dev --no-open` | 用于启动预览服务器的命令，从项目根目录运行。 |
+| `mintlify.preview.followScroll` | `true` | 将预览滚动到最接近编辑器顶部的标题处。 |
+
+`mintlify.preview.command` 是用户级设置，工作区无法覆盖它。这可以防止克隆的仓库在你打开预览时在你的机器上运行任意命令。
+
+
+ ## 命令
+
+
+在命令面板中运行以下命令：
+
+| 命令 | 说明 |
+| --- | --- |
+| **Mintlify: Preview Mintlify** | 为当前文件打开预览面板。 |
+| **Mintlify: Stop preview server** | 停止正在运行的预览服务器。 |
+| **Mintlify: Show detected docs root** | 显示扩展解析到的 `docs.json` 文件。 |
+| **Mintlify: Open component docs** | 打开光标所在组件的文档。 |
+| **Mintlify: Restart language server** | 重启语言服务器。 |
+
+
+ ## 冲突的扩展
+
+
+其他 MDX 扩展为 `.mdx` 文件提供各自的语法高亮和语言功能，会与此扩展冲突。请禁用其他 MDX 扩展，以避免重复的提示和不一致的高亮。
+
+对于代码格式化，请将 [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) 与此扩展搭配使用，或运行 [`mint format`](/zh/cli/commands#mint-format)。
+
+
+ ## 故障排除
+
+
+
## 登录以启用搜索和助手
diff --git a/zh/create/list-table.mdx b/zh/create/list-table.mdx
index e009416c5c..aa712cf2cd 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 64d0918edd..22622f4f9c 100644
--- a/zh/customize/custom-scripts.mdx
+++ b/zh/customize/custom-scripts.mdx
@@ -208,7 +208,14 @@ Mintlify 提供两种类型的 CSS 定位钩子：
- `breadcrumb-item`—单个面包屑项。
@@ -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 子域上基础路径下的文件。
@@ -220,6 +227,20 @@ Mintlify 会重新构建你的文档以在你的基础路径下提供服务，
- 停止转发 `Host` 头
- 将 `Origin` 头设置为你的 Mintlify 子域（`.mintlify.site`）
+/*` 路由，或在细粒度允许列表中添加 `/_llms/*`。
+- 重新部署文档，然后同时验证 `/llms.txt` 和一个链接的 `/_llms/*.md` URL。
+
部署用分支 | 无 | **Publish** 直接发布到你的线上站点 |
-| 部署用分支 | 需要拉取请求 | **Create branch** 将更改转移到新分支 |
-| 功能分支 | 无 | **Save in branch**、**Create pull request** |
-| 功能分支 | 需要拉取请求 | **Save in branch**、**Create pull request** |
-
-- **Publish**：立即将你的更改提交并部署到线上站点。
-- **Save in branch**：将更改提交到功能分支，但不合并到部署用分支。
-- **Create branch**：当你在受保护的部署用分支上时，将待处理的更改转移到一个新的功能分支。
-- **Create pull request**：打开一个以你的部署用分支为目标的拉取请求。
-
-如果没有待处理的更改，编辑器会禁用发布和保存操作。
-
-
- 在 Mintlify 构建并部署你的更改后，你的线上站点会更新。这通常需要 30 秒到几分钟。请在你的 [dashboard](https://app.mintlify.com) 上查看部署状态。
-
-
-
- 使用具有描述性的分支名称，这样你能轻松识别它们，其他人也能理解每个分支的用途。
-
-
-
- 在你有未发布更改时切换分支，编辑器会提示你将这些更改带到新分支，或者将它们留下。留下的更改会保留在原始分支上。
-
-
-
- 要复制分支名称，将鼠标悬停在下拉菜单中的分支上并点击复制图标。在与团队成员共享分支或在拉取请求中引用它时，这会很有用。
-
-
-
-
-
-
-复制该 URL 并发送给审查者。每次保存到该分支时，预览都会自动更新。
-
-
- 在你的 Git 服务提供商中配置分支保护规则以要求拉取请求。请参阅 GitHub 文档中的 [About protected branches](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches) 或 GitLab 文档中的 [Protected branches](https://docs.gitlab.com/user/project/repository/branches/protected/)。
-
-
-
+ ### 生成的 `/_llms/` 链接返回 404
+
+
+**症状**：`llms.txt` 文件可以加载，但 `/_llms/` 下的链接返回 404 或缺少你的公开子路径。
+
+**原因**：公开子路径与在 Mintlify 中配置的基础路径不匹配，或者代理仅转发了 `llms.txt` 而没有转发其生成的索引路由。
+
+**解决方案**：
+
+- 在 Mintlify 控制台中将公开子路径设置为基础路径。仓库中同名的目录并不会配置基础路径。
+- 转发完整的 `
### 性能问题
diff --git a/zh/editor/agent.mdx b/zh/editor/agent.mdx
index 28f4887874..e268466e60 100644
--- a/zh/editor/agent.mdx
+++ b/zh/editor/agent.mdx
@@ -1,30 +1,24 @@
---
-title: "向代理提问"
-description: "使用编辑器内置的 AI 代理撰写内容、编辑页面、留下评论和建议、跨站点搜索、上传文件并配置设置。"
-keywords: ["编辑器", "AI", "助手", "代理", "聊天", "评论", "建议", "code mode", "文件上传"]
+title: "询问智能体"
+description: "使用编辑器内置的 AI 智能体撰写内容、编辑页面、留下评论和建议、搜索站点、上传文件并配置设置。"
+keywords: ["editor", "AI", "assistant", "agent", "chat", "comments", "suggestions", "code mode", "file upload"]
---
-编辑器内置了一个代理，可以编辑页面、重新组织导航、更新 `docs.json`、在整个仓库中搜索以及管理控制台设置。
+编辑器内置了一个智能体，可以编辑页面、重新组织导航、更新 `docs.json`、在整个仓库中搜索，以及管理仪表板设置。
-编辑器代理会直接在你的当前 branch 中进行更改。
+编辑器智能体会直接在你当前的分支上进行修改。
- ## 打开代理
-
-
-点击编辑器工具栏中的 **Ask agent**，或按 Cmd + I (macOS) 或 Ctrl + I (Windows)。
-要关闭面板，请点击面板标题栏中的 **X** 按钮，或再次按 Cmd + I。
+## 打开智能体
-
- ## 发送消息
-在面板底部的聊天框中输入你的请求，按 Enter 或点击
- ## 附加文件
+
+## 附加文件
+
-点击聊天框中的回形针图标，或将文件拖放到面板上。代理会读取附加的文件作为请求的上下文。
+点击聊天框中的回形针图标，或把文件拖放到面板上。智能体会把附加的文件作为你请求的上下文来读取。
支持的文件类型：
-- **图像**：JPG、PNG、GIF、WebP、SVG
+- **图片**：JPG、PNG、GIF、WebP、SVG
- **文档**：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 会移除其中的脚本和其他活动内容。
- ## 将选中内容添加到代理
+
+## 把选中内容添加到智能体
+
-在可视化模式下，在页面上选中文本。选区上方会出现一个浮动工具栏。点击 **Add to agent**，将所选文本作为上下文发送给代理。
+在可视化模式下选中文本，然后点击浮动工具栏中的 **Add to agent**，即可把它作为上下文发送给智能体。
- ## 请求评论和建议
+
+## 请求评论和建议
+
-代理默认会直接编辑内容。如果你希望获得反馈而不立即修改页面，请明确要求代理审阅页面、留下评论或提出建议。
+默认情况下，智能体会直接修改内容。如果你想获得反馈但暂时不改动页面，请明确要求它审阅页面、留下评论或提出建议。
-- [建议](/zh/editor/suggestions)会提议一处具体的替换，你可以接受或拒绝。在你做出决定之前，原文会以删除线的形式保持可见，代理还可以在建议线程中附上说明。
-- [评论](/zh/editor/comments)会针对具体文本留下反馈或问题，不会修改页面本身。
+- [建议](/zh/editor/collaborate#suggestions)会提议一处具体的替换，你可以接受或拒绝。在你做出决定之前，原文会以删除线的形式保持可见，智能体还可以在建议线程中附上说明。
+- [评论](/zh/editor/collaborate#comments)会针对具体文本留下反馈或问题，不会修改页面。
-示例 prompts：
+示例提示：
- `review this page and leave suggestions`
- `comment on anything that needs more context`
- `suggest ways to make the introduction more concise`
-除非你指定另一页，否则代理会使用你当前打开的页面。它可以标注页面上渲染出的文本，包括组件内的正文，但不能标注 frontmatter、页面元数据、配置或 MDX 组件的原始标签与属性。
+除非你指定其他页面，智能体会使用你当前打开的页面。它可以标注页面渲染后的文本，包括组件内部的正文。它无法标注 frontmatter、页面元数据、配置，以及原始的 MDX 组件标签和属性。
- ## 查看代理的更改
+
+## 查看智能体的修改
+
-代理在编辑页面时，聊天中会出现 **Changed files** 面板。展开后可看到本次会话中修改的每个文件的列表。点击任意文件可在差异视图中打开它，将代理的更改与原文对比。
+智能体工作时，聊天中会出现 **Changed files** 面板。展开它可以查看本次会话中修改的所有文件，点击任意文件即可在 diff 视图中与原始版本进行比较。
- ## 代理可以做什么
+
+## 智能体能做什么
+
- ### 编辑页面
+
+### 编辑页面
+
-代理可以在任意页面上撰写、改写、扩展和重新组织内容。它会阅读你现有的内容，以匹配你的风格和结构。
+智能体可以在任意页面上撰写、改写、扩写和重新组织内容。它会阅读你已有的内容，以匹配你的风格和结构。
-代理可以在整个仓库中搜索，而不仅限于你当前打开的页面。可借助它查找信息、检查不一致之处，或在添加内容前确认内容是否已经存在。
+智能体可以在整个仓库中搜索，而不仅限于你打开的页面。你可以用它查找信息、检查不一致之处，或在新增内容前确认相关内容是否已经存在。
-代理可以添加、重命名、重新排序和删除导航元素，这与你在导航面板中手动进行的更改相同。它还可以直接更新 `docs.json` 配置，包括添加新组、调整设置和配置重定向。
+智能体可以添加、重命名、重新排序和删除导航元素，与你在导航面板中手动进行的修改相同。它还可以直接更新 `docs.json` 配置，包括添加新的 group、调整设置和配置重定向。
示例：`add a "Quickstart" group under the Getting Started tab and move the quickstart page into it`
- ### 运行 bash 命令
+
+### 运行 bash 命令
+
-代理可以对你的仓库运行 `grep`、`rg` 和其他 bash 命令。可用于跨多个文件的批量操作。
+智能体可以对你的仓库运行 `grep`、`rg` 等 bash 命令。适合跨多个文件的批量操作。
示例：`find every page that mentions the deprecated /v1/auth endpoint`
- ### 配置你的站点 (code mode)
+
+### 配置站点（code mode）
+
-对于超出页面编辑范围的请求 (例如设置身份验证、管理工作流或更改部署设置)，代理会切换到 code mode。它会代你编写并对 Mintlify 控制台运行脚本。
+对于超出编辑页面范围的请求（例如设置认证、管理 workflow 或修改 deployment 设置），智能体会切换到 code mode。它会代表你编写并运行针对 Mintlify 仪表板的脚本。
-Code mode 会遵循你在控制台中的权限。如果你在控制台中无权访问某项设置，代理也无法更改它。
+Code mode 会遵循你在仪表板中的权限。如果你无权访问某项设置，智能体同样无法修改它。
-会使用 code mode 的示例提示词：
+使用 code mode 的示例提示：
- `enable JWT authentication for my site`
- `create a workflow that updates my site when I merge a PR`
- `add a custom domain`
- ### 继续自动化运行
+
+### 继续自动化运行
+
-当你通过点击 **View changes** 从已完成的自动化运行中打开编辑器时，代理面板会自动打开，并带有关于该自动化所执行操作的上下文。聊天顶部会显示一张 **Changed pages** 卡片，列出该自动化修改的每个页面——点击任意页面可打开差异视图。
+当你点击 **View changes** 从已完成的自动化运行中打开编辑器时，智能体面板会自动打开，并带有该自动化所做工作的上下文。聊天顶部的 **Changed pages** 卡片会列出该自动化修改的所有页面。点击任意页面即可打开 diff 视图。
-代理拥有该自动化提示词、所做更改的摘要以及它修改的页面的上下文。你可以让它细化或扩展该自动化的工作，无需再次说明背景。
+智能体掌握该自动化的提示、所做修改的摘要，以及它修改了哪些页面。你可以请它完善或延续这项工作，而无需重新说明背景。
例如：`The new section on rate limits is too long. Trim it to three sentences.`
- ## 会话历史
+
+## 会话历史
+
-点击面板标题栏中的时钟图标，可查看你之前的聊天会话。点击任意会话可重新打开它，并查看代理的更改。
+点击面板标题栏中的时钟图标，即可查看之前的聊天会话。点击任意会话可重新打开它，并查看智能体做了哪些修改。
- ## AI 指令
+
+## AI 说明
+
-要为代理提供持久性指引 (例如语气规则、术语或格式约定)，请在[编辑器设置](/zh/editor/settings#ai-instructions)中配置 AI 指令。代理会在每次请求时遵循这些指令，无需你重复说明。
+若要为智能体提供持久性指导，例如语态规则、术语或格式约定，请在[编辑器设置](/zh/editor/settings#ai-instructions)中配置 AI 说明。智能体会在每次请求时遵循这些说明，你无需重复说明。
diff --git a/zh/editor/branching-and-publishing.mdx b/zh/editor/branching-and-publishing.mdx
deleted file mode 100644
index 8d5080b677..0000000000
--- a/zh/editor/branching-and-publishing.mdx
+++ /dev/null
@@ -1,224 +0,0 @@
----
-title: "分支与发布"
-description: "了解分支及保护规则如何决定发布时所发生的操作，以及如何管理完整的审查与部署工作流。"
-keywords: ["编辑器", "分支", "发布", "拉取请求", "预览", "git", "合并", "部署"]
----
-
-Web 编辑器会在你输入时自动保存所有内容，但你的更改只有在你选择发布后才会上线。
-
-发布时所发生的具体操作取决于两件事：**你当前所在的分支**，以及**该分支是否要求拉取请求**。
-
-
- ## 保存与发布
-
-
-**保存**会自动进行。Mintlify 会将你的编辑存储在其服务器上，并在浏览器标签页、设备以及网络中断之间保留这些内容。
-
-**发布**会将你的更改提交到你的 Git 存储库。点击工具栏中的 **Publish** 以打开发布菜单，将你的更改保存为一次 Git 提交，并创建一个拉取请求。
-
-编辑器会将以下内容作为待处理的更改进行跟踪：
-
-- 页面中的内容编辑
-- 新建或删除的页面
-- 导航结构的更改
-- 媒体上传
-- 配置更新
-
-
- ## 发布时会发生什么
-
-
-点击发布按钮后可用的操作取决于你当前所在的分支，以及该分支是否设置了要求拉取请求的分支保护规则。
-
-| 分支类型 | 分支保护 | 可用操作 |
-|-------------|-------------------|-------------------|
-|
- ## 何时使用分支
-
-
-如果你不使用基于 Git 的工作流，请**直接在部署用分支上编辑**。
-
-当你使用基于分支的工作流，且每次更改都在单独的分支上进行时，请**创建一个分支**。
-
-
- ## 创建和切换分支
-
-
-
- ### 创建分支
-
-
-1. 点击编辑器工具栏中的分支名称。
-1. 点击 **Create new branch**。
-1. 如果你有待处理的更改，选择是将它们带到新分支，还是留在当前分支上。
-1. 输入名称并点击 **Create branch**。
-
-
- ### 切换分支
-
-
-1. 点击工具栏中的分支名称。
-1. 搜索或滚动到你想要的分支。
-1. 点击分支以切换到该分支。
-
-
- ## 预览你的更改
-
-
-每次你将更改保存到功能分支时，Mintlify 会构建一个预览部署——一个临时 URL，你的更改会在那里以发布后完全相同的样子呈现。
-
-
-
-1. 点击编辑器工具栏中的 **Publish**。
-1. 在发布菜单中，点击预览 URL。URL 格式为 `organization-branch-name.mintlify.site`。
-
-
-
-
-
-复制该 URL 并发送给审查者。每次保存到该分支时，预览都会自动更新。
-
-
- ### 限制对预览的访问
-
-
-预览 URL 默认是公开可访问的。要将访问限制为你的 Mintlify 组织成员，请在控制台的 [Add-ons](https://app.mintlify.com/products/addons) 页面中启用预览身份验证。
-
-
-
-要邀请团队成员到某个分支上的特定页面，请从你的浏览器地址栏复制 URL 并分享出去。任何有权限访问你的 Mintlify 组织的人都可以直接在他们的编辑器会话中打开该链接。
-
-URL 格式为：
-
-```text
-https://app.mintlify.com/{org}/{project}/editor/{branch}/~/{filepath}
-```
-
-例如：`https://app.mintlify.com/acme/docs/editor/main/~/guides/quickstart.mdx`
-
-
- ## 审查并合并拉取请求
-
-
-当当前分支有打开的拉取请求时，发布菜单会显示一个审查面板，其中包含：
-
-- 拉取请求的标题、描述以及是否为草稿。
-- 源分支和目标分支。
-- 更改的文件数量。
-- 部署用分支上的审批要求：**Approval required**、**Code owner required** 或无要求。
-- 当前的审查状态：**Approved**、**Changes requested** 或 **Awaiting review**。
-
-点击拉取请求链接以在 GitHub、GitLab 或 Bitbucket 中打开它。
-
-在审查者批准拉取请求后，点击 **Merge and publish** 可直接从编辑器中合并并部署。编辑器会在合并后切换到你的部署用分支。
-
-
- ### 在编辑器中批准拉取请求
-
-
-对于 GitHub 存储库，审查者可以在编辑器中批准打开的拉取请求。当有打开的拉取请求时，如果你的账户具有审查权限，审查面板中会出现 **Approve pull request** 按钮。当更改可以合并时，点击 **Approve pull request**。审查状态会更新为 **Approved**，并且 **Merge and publish** 操作将变为可用。
-
-对于草稿拉取请求或你已批准的拉取请求，批准操作不可用。如果你使用 GitLab 或 Bitbucket，请在你的 Git 服务提供商中打开拉取请求进行审批。
-
-
- ### 在合并前审查更改
-
-
-点击发布菜单中任何已更改的文件，即可在差异视图中打开它，并将你的分支与已发布版本进行比较。在可视化模式下，你会看到可视化差异；在源代码模式下，你会看到文本差异。无法显示差异的文件（如图片或已删除的文件）会出现在列表中，但不可点击。
-
-文件树会高亮显示已变更的页面，让你一眼就能看出 [automation](/zh/automations) 或团队成员改动了哪些文件。出现在分支差异中的未列出页面，即使它们不在站点导航中，也可以从发布菜单中打开。
-
-
- ### 在编辑器中打开自动化运行
-
-
-当 [automation](/zh/automations) 打开一个拉取请求时，你可以直接从运行审查 UI 或其 Slack 通知跳转到编辑器，并切换到该自动化的分支：
-
-- 在控制台的 **Automation Runs** 页面中，点击已完成运行上的 **Open in editor**。
-- 在 Slack 通知中，点击 **View changes** 链接。
-
-任一入口都会打开编辑器并切换到该自动化的分支，发布菜单中会预选已变更的页面。你无需离开编辑器即可审查差异并合并或请求更改。
-
-
- ### 同时发布
-
-
-每个分支同一时刻只能有一次发布。如果另一位团队成员正在向同一分支发布，请等待当前发布完成后再重试。
-
-
- ### Pull request 标题和描述
-
-
-如果你的组织要求使用 pull request，你可以在发布时输入标题和描述。如果其中任一项留空，编辑器会使用默认信息，其中列出你创建、更新、移动或删除的文件。
-
-
- ## 解决冲突
-
-
-当你的分支和部署用分支对同一文件有不兼容的更改时，就会发生冲突。例如，你和团队成员编辑了同一文件中的同一行，或将文件移动到了不同位置。
-
-当冲突阻止发布时，编辑器会显示警告。按照提示选择保留每个冲突部分中的哪个版本。
-
-
- ## 实时协作
-
-
-当多人在同一分支上打开同一页面时，他们会实时一起编辑。每个人的光标和编辑对所有人都可见，并在工具栏中显示头像。
-
-- 来自所有协作者的更改会自动合并。两个人编辑同一部分不会产生冲突。
-- 撤销只会影响你自己的编辑。
-- 如果你的连接断开，编辑会在本地保存，并在重新连接时同步。
-
-当 [Mintlify agent](/zh/agent) 通过 API 或 MCP 编辑页面时，它会像任何其他协作者一样出现在编辑器中。你会在工具栏中看到该代理的头像，并在其最近编辑位置看到一个实时光标。代理完成后，光标会自动消失。
-
-
- ## Git 同步
-
-
-当有人从编辑器之外向你的存储库推送更改时，编辑器会自动合并这些更改。
-
-不重叠的更改会自动应用。如果远程更改和你的本地编辑影响了页面的同一部分，编辑器会高亮该冲突，以便你解决它。
-
-
- ## 提交签名
-
-
-在你的[账户设置](https://app.mintlify.com/settings/account)中授权你的 GitHub 账号，即可用该账号对提交进行签名。若未完成授权，则由 Mintlify GitHub 应用对在 Web 编辑器中完成的提交进行签名。
-
-有关编辑器操作如何映射到 Git 操作的参考，请参阅 [Git 基础](/zh/editor/git-essentials#how-the-editor-maps-to-git)。
diff --git a/zh/editor/collaborate.mdx b/zh/editor/collaborate.mdx
index b262e215ed..ca45f5e47b 100644
--- a/zh/editor/collaborate.mdx
+++ b/zh/editor/collaborate.mdx
@@ -1,125 +1,82 @@
---
-title: "在 Web 编辑器中协作"
+title: "在编辑器中协作"
sidebarTitle: "协作"
-description: "通过实时协作、实时光标、可分享的编辑器链接、branch 以及拉取请求审查工作流，与团队一起编辑文档。"
-keywords: ["编辑器", "协作", "实时", "实时编辑", "branch", "拉取请求", "预览部署", "可分享链接"]
+description: "在编辑器中留下评论、以建议的形式提出修改，并与同事实时协同编辑。"
+keywords: ["comments", "suggestions", "collaboration", "review", "mentions", "real time"]
---
-通过实时编辑和基于 branch 的工作流，与团队协作撰写文档。
+你可以通过评论页面、对页面提出建议，或与同事同时协同编辑，来与团队一起处理页面。
-
- ## 实时协作
-
-
-多人可以同时编辑同一个页面。每个人所做的更改都会显示给页面上的所有其他人。
-
-要在某个页面上进行实时协作，请将该页面的编辑器链接分享给你的队友。请参阅下方的 [分享编辑器链接](#share-editor-links)。
+
-
- 
- 
-
+## 评论
-
-
-
+## 评论
-
- ### 实时编辑的工作原理
-当多个团队成员同时编辑同一个 branch 时，更改会实时同步。页面内容、导航结构和站点配置的更新会自动出现在所有协作者那里，无需刷新。
+评论让你可以针对特定文本留下反馈，而无需修改内容。
-- 每个人的光标和编辑都对页面上的所有人可见，工具栏中会显示用户的头像和姓名。
-- 更改会自动合并。两人同时编辑同一段内容不会引起冲突。
-- 撤销仅作用于你自己的更改——撤销不会回退他人所做的修改。
-- 如果你失去网络连接，你的编辑会保存在本地，并在重新连接后同步。
+**评论永远不会进入你的仓库。** 它们只存在于编辑器中，不会包含在已发布的站点里，也不会提交到 Git。
-
- ## 实时查看 agent 的编辑
-
-
-当 [Mintlify agent](/zh/agent) 通过 API 或 MCP 编辑页面时，它会像任何其他协作者一样出现在 Web 编辑器中。如果你在同一 branch 上打开了该页面，你会在编辑器顶部看到 agent 的头像和名称，并在其最近一次编辑的位置看到实时光标。
+若要添加评论，请选中文本并点击工具栏中的
+
+
-- 实时查看 agent 对页面所做的更改。
-- 无需对比文件即可知道 agent 刚刚更新了哪个段落或区块。
-- 在同一 branch 上与队友和 agent 协调工作，避免互相覆盖彼此的工作。
+所有[角色](/zh/dashboard/roles)都可以发表评论和回复，包括 viewers。只有 editors 和 admins 可以解决线程。解决线程会把它从侧边栏中移除，并清除页面上的高亮。
-agent 完成编辑后不久，其光标会自动消失。
+你可以删除自己的评论，admins 可以删除任何评论。删除线程中的第一条评论会删除整个线程。
-
- ## 基于 branch 的协作
-
+输入 `@` 提及同事。对方必须是你所在组织的成员，并会收到电子邮件通知。
-使用 branch 并行更新文档，在不影响线上站点的前提下完成修改。如果你不熟悉 Git，请参阅 [Web 编辑器的 Git 基础](/zh/editor/git-essentials)。
+如果你的分支存在打开的 pull request，Mintlify 会在其描述中添加未解决线程的摘要，并附上指向每条评论的链接。该摘要会随线程的变化而更新。
-
- ### 为什么要使用 branch
-
+
-- **隔离更改**：在不影响线上文档的情况下进行更新。
-- **发布前评审**：在更改上线之前先获取团队成员的反馈。
-- **并行协作**：多个团队成员可以同时在不同的 branch 上工作。
+## 建议
-
-
- 当你准备好发布更改时，可以在编辑器中创建拉取请求。更多信息请参阅 [Branching and publishing](/zh/editor/publish)。
-
+Editors 和 admins 可以接受或拒绝任何建议，viewers 不能。
-
- 在你的 Git 托管平台（如 GitHub 或 GitLab）中审查拉取请求。
-
+若要提出建议，请选中文本并点击工具栏中的
- 当审查者请求更改时，在编辑器中进行所需的修改。后续的更改会自动推送到现有的拉取请求中。
-
+
+ [Viewers](/zh/dashboard/roles) 始终处于建议模式。viewer 打开编辑器时会自动进入建议模式，这样他们就可以在不直接修改内容的情况下提出修改。
+
-
- 当所有请求的更改都已处理、必需审查者已批准且所有自动检查均已通过时，合并你的拉取请求。
-
-
+点击高亮显示的建议即可接受或拒绝。无论选择哪一项，该建议线程都会被解决并删除。被接受的修改会成为当前分支的一部分，并在你下次[发布](/zh/editor/publish)时上线。
-
- ## 推荐工作流
-建议使用拉取请求（PR；亦称“合并请求”/Merge Request）在合并到线上文档之前提出更改并与团队协作。此工作流可以确保团队在发布前完成审查，并保持清晰的更新历史记录。
+建议会在保留当前内容的前提下提出修改，便于同事接受或拒绝。
-
- ## 预览部署
-
+
-预览部署会创建临时 URL，你可以在更改正式上线之前先查看渲染效果。使用预览部署来收集关于你更改的反馈。
+## 询问 Mintlify 智能体
-每次你在某个 branch 上发布更改时，预览部署都会自动更新。
-
-
-
- 在特定时间点保存的更改快照。每次提交都包含一条描述更改内容的消息，并在你的项目历史中创建一条永久记录。
-
- 当你发布更改时，Web 编辑器会在你的 Git 存储库中创建一次提交。
-
-
- 存储库中的一条独立工作线路，有时称为 **功能分支（feature branch）**。
-
- 你的在线文档是从一个 **部署用分支** 构建的，通常名为 `main`。其他分支让你可以独立进行修改，而不影响你的线上站点。在将某个分支通过拉取请求合并到部署用分支之前，该分支上的任何内容都不会上线。
-
- 通过编辑器工具栏中的分支下拉菜单在不同分支之间切换。如果你有未发布的更改，编辑器会让你选择将更改带到新分支或保留在当前分支。
-
-
- 用于构建你的线上文档站点的分支，通常名为 `main`。合并到该分支的更改会自动部署到你的站点。
-
-
- 一个将更改从一个分支合并到另一个分支的提案。拉取请求可以让你的团队在更改上线之前进行审查和讨论。
-
- 当你在功能分支上发布更改时（或当你的存储库要求使用拉取请求时），Web 编辑器会创建一个拉取请求。你的团队会在 Git 提供商（GitHub、GitLab 或 Bitbucket）中审查并合并该拉取请求。
-
-
- 将一个分支中的更改合并到另一个分支中。在你的团队审查并批准拉取请求之后，合并该分支会把你的更改纳入部署用分支并发布。
-
-
- 当两个分支对相同文件包含不兼容的更改时就会发生冲突。编辑器会在冲突发生时帮助你解决它们。
-
-
- 显示文件两个版本之间差异的对比视图。编辑器会在你发布之前显示待提交更改的可视化差异，便于你准确审阅将要提交的内容。
-
-
-
-
+
+ 创建分支、进行修改、共享预览并发布。
+
-
+使用编辑器在浏览器中撰写和发布文档。编辑器采用 docs-as-code 工作流，你的所有更改都由 Git 保存。你的工作会以 commit 的形式保存在仓库中，编辑器会替你处理 Git 操作。
-编辑器让你的内容与 Git 仓库保持同步，并让整个团队可以实时协同编辑。
+打开[仪表板](https://app.mintlify.com)时会默认加载编辑器。组织中的任何成员都可以打开编辑器，但具体能执行哪些操作取决于你的[角色](/zh/dashboard/roles)。Admins 和 editors 可以编辑和发布。Viewers 可以浏览内容，并留下[评论和建议](/zh/editor/collaborate)。
-
- ### 访问预览部署
-1. 在编辑器工具栏中点击 **Publish**。
-2. 点击预览 URL，在新标签页中打开预览部署。URL 的格式为 `organization-branch-name.mintlify.site`。
+在评论、建议或回复中提及 `@mintlify`，即可就当前页面向[编辑器智能体](/zh/editor/agent)提问。智能体会在后台运行，并以该页面、线程和分支作为上下文，然后把回答作为回复发布到同一线程中。
-
+```text
+@mintlify does this endpoint support pagination?
+@mintlify are there any pages that contradict this?
+```
-将预览部署的 URL 分享给团队成员以收集反馈。当你发布更多更改时，预览会自动更新。
+智能体在回复评论时以只读模式运行。它可以搜索你的文档、阅读页面、获取网页内容并加载 skills，但无法编辑内容、创建建议或发布。若要进行修改，请直接打开[编辑器智能体](/zh/editor/agent)。
-
- ### 预览认证
-
-
-预览 URL 默认对所有人公开可访问。在控制台的 [附加组件（Add-ons）](https://dashboard.mintlify.com/products/addons) 页面启用预览认证，以将访问限制为已通过认证的组织成员。
+对于已有访问权限的成员，提及功能在私有页面上同样有效。每条回复都会计入你的编辑器智能体用量。
-
+
-将编辑器中某个特定页面的直接链接分享给你的团队成员。使用编辑器链接可以实时协作更新内容，或将队友定位到特定页面。
+## 实时编辑
-当你在页面之间导航时，编辑器 URL 会自动更新。从浏览器地址栏中复制该 URL，与有编辑器访问权限的团队成员分享。
+
-URL 的格式是：`https://dashboard.mintlify.com/{org}/{project}/editor/{branch}/~/{filepath}`
+当多人在同一分支上打开同一页面时，他们会协同编辑。每个人的光标和编辑对所有人可见，工具栏中会显示头像。
-例如，`https://dashboard.mintlify.com/acme/docs/editor/main/~/guides/quickstart.mdx` 会在 `main` branch 上打开 `quickstart.mdx` 文件。
+- 所有协作者的更改会自动合并。两人编辑同一部分不会产生冲突。
+- 撤销只影响你自己的编辑。
+- 如果你断开连接，编辑会保存在本地，并在重新连接时同步。
-任何有权访问你所在 Mintlify 组织的人都可以使用该链接直接在编辑器中打开该文件。
+当 [Mintlify 智能体](/zh/agent)通过 API 或 MCP 编辑页面时，它会像其他协作者一样出现，带有头像和位于其最近编辑位置的实时光标。智能体完成后，光标会自动消失。
diff --git a/zh/editor/comments.mdx b/zh/editor/comments.mdx
deleted file mode 100644
index c959613763..0000000000
--- a/zh/editor/comments.mdx
+++ /dev/null
@@ -1,92 +0,0 @@
----
-title: "评论"
-description: "在编辑器中对页面留下行内评论，与团队成员反馈意见、提出问题并讨论更改。"
-keywords: ["editor", "评论", "协作", "反馈", "提及", "讨论线程"]
----
-
-评论功能可让你和你的团队针对页面中的特定文本留下反馈，而无需修改内容。使用评论在发布之前提出问题、指出问题或讨论更改。
-
-评论仅存在于编辑器内部。它们永远不会包含在已发布的网站中，也不会提交到你的仓库。
-
-所有[角色](/zh/dashboard/roles)——viewers、editors 和 admins——都可以留下评论并回复评论。只有 editors 和 admins 可以解决评论线程。
-
-如果你的分支有一个已打开的 pull request，Mintlify 会将未解决的评论线程摘要添加到该 pull request 的描述中。摘要会列出包含未解决评论的文件、每个线程中的第一条评论，以及跳转到编辑器中相应评论的链接。
-
-当你添加、解决或删除评论时，摘要会自动更新。
-
-
- ## 添加评论
-
-
-1. 选中要评论的文本。
-2. 在工具栏中点击
-
-
-
-
-
-要打开评论线程，请点击带高亮的文本或点击评论侧边栏中的线程。输入你的回复，然后按 Enter 提交。
-
-
-
-
-
-
-
- ## 提及团队成员
-
-
-在评论或回复中输入 `@` 即可提及团队成员。你只能提及所属组织中的成员。
-
-被提及的团队成员会收到电子邮件通知。
-
-
- ## 解决评论
-
-
-当讨论结束时，editors 和 admins 可以解决评论线程。
-
-点击对勾图标可解决线程。 已解决的讨论线程会从评论侧边栏中移除，页面上的高亮也会被清除。
-
-
-
-
-
-
-
- ## 删除评论
-
-
-点击评论旁边的垃圾桶图标即可删除该评论。删除线程中的第一条评论会删除整个线程。
-
-你可以删除自己的评论。admins 可以删除任何评论。
diff --git a/zh/editor/configurations.mdx b/zh/editor/configurations.mdx
deleted file mode 100644
index d5ec7d6567..0000000000
--- a/zh/editor/configurations.mdx
+++ /dev/null
@@ -1,168 +0,0 @@
----
-title: "配置"
-description: "使用 Mintlify 网页编辑器侧边栏中的可视化配置表单编辑页面元数据、导航元素和媒体设置。"
-keywords: ["editor", "configurations", "settings"]
-boost: 3
----
-
-在 Web 编辑器的 **Configurations** 面板中配置文档站点的品牌、外观和功能。
-
-
-
-
-
-
-
-
- ## 设置站点品牌
-
-
-设定站点的标识，以及它在访问者眼中的呈现方式。
-
-* **文档标题 (Docs title) **：你的文档名称。会显示在浏览器标签页和搜索结果中。
-* **摘要 (Description) **：对文档的简要概述。用于 SEO (搜索引擎优化) 和站点 metadata。
-* **Favicon**：显示在浏览器标签页中的小图标。可上传 ICO、PNG、GIF 或 JPG 文件。
-* **Theme**：为文档的整体外观选择一个[主题](/zh/customize/themes)。
-
-
- ## 自定义颜色和外观
-
-
-控制你站点的视觉标识和配色方案。
-
-* **主色**：站点中用于链接、按钮和高亮的主要强调色。
-* **浅色模式颜色**：浅色模式下的强调色变体。具体应用方式因主题而异。
-* **深色模式颜色**：深色模式下的强调色变体。具体应用方式因主题而异。
-* **Logo**：你的品牌 Logo。上传 PNG 或 JPG 文件。你可以为浅色和深色模式分别设置不同的 Logo。如需使用 SVG Logo，请通过 Git 将文件添加到你的仓库，并在 docs.json 配置中引用其路径。
-* **Logo 链接**：用户点击 Logo 时跳转到的位置。通常是你的首页或营销站点。
-* **背景颜色**：分别为浅色和深色模式设置自定义背景色。
-* **背景图片**：为站点添加背景图片。上传 PNG、GIF 或 JPG 文件。
-* **背景装饰**：为背景图片应用视觉效果。
-* **主题切换**：控制是否向用户显示浅色/深色模式切换开关。
-* **默认主题**：设置站点默认以浅色或深色模式加载。
-
-
- ## 设置自定义字体
-
-
-将默认字体替换为你的品牌字体体系。
-
-* **默认字体**：用于所有文本的基础字体系列和字重。提供一个来源 URL 和格式 (WOFF 或 WOFF2) 。
-* **标题字体**：专门用于标题 (h1、h2 等) 的字体系列和字重。与正文文本分开设置。
-* **正文字体**：用于正文文本和段落的字体系列和字重。
-
-对于每种字体，指定字体系列名称、字重、来源 URL (例如 Google Fonts) ，以及格式。
-
-
- ## 配置页眉
-
-
-在站点顶部添加导航元素。
-
-* **导航栏按钮**：在页眉中添加一个主要的行动号召按钮。设置按钮类型、标签和目标 URL。
-* **导航栏链接**：在页眉中添加额外的导航链接。每个链接都包含文本和一个 URL。
-
-
-
-在站点页脚中添加链接和社交媒体账号。
-
-* **社交链接**：添加你在 GitHub、X (Twitter) 、LinkedIn、Discord、YouTube、Slack 等平台上的个人或组织主页。
-* **页脚列**：通过自定义标题和链接分组，将页脚链接组织成多列。
-
-
- ## 增强内容
-
-
-自定义你的网站上内容的呈现方式。
-
-* **缩略图背景**：为页面缩略图和社交分享预览设置自定义背景图片。
-* **缩略图外观**：控制缩略图的展示方式。
-* **缩略图字体**：为缩略图中的文本设置自定义字体。
-* **页面眉标题**：在页面标题上方添加小标签。
-* **代码块主题**：为代码块选择语法高亮主题。
-* **LaTeX 支持**：启用使用 LaTeX 渲染数学公式。
-
-
- ## 设置 AI 聊天和搜索
-
-
-自定义搜索体验。
-
-* **搜索占位文本**：在用户输入之前显示在搜索框中的文本。默认值为“Search or ask...”。
-
-
- ## 连接集成
-
-
-连接第三方工具以实现分析、支持和合规等功能。
-
-
- ## 配置 API 规范
-
-
-添加 [OpenAPI](/zh/api-playground/openapi-setup) 或 [AsyncAPI](/zh/api-playground/asyncapi-setup) 规范文件来为 API 端点编写文档。
-
-* **OpenAPI 规范**：上传 OpenAPI 规范文件，或输入指向外部 OpenAPI 文件的 URL。
-* **AsyncAPI 规范**：上传 AsyncAPI 规范文件，或输入指向外部 AsyncAPI 文件的 URL。
-* **操作台显示**：选择显示交互式 API 操作台、简易 API 操作台，或不显示 API 操作台。
-* **代理服务器**：为 API 请求启用或禁用代理服务器。
-
-
- ## 管理重定向
-
-
-使用 **Redirects** 部分可以添加、编辑、搜索和删除重定向，无需手动修改 `docs.json` 文件。重定向会将用户从旧 URL 导向新 URL，在你重命名页面或重构文档结构时非常有用。有关重定向行为的更多信息，请参阅 [重定向](/zh/create/redirects)。
-
-每条重定向包含以下字段：
-
-- **Source**: 要从其重定向的路径，例如 `/old-path`。支持通配符。
-- **Destination**: 要重定向到的路径，例如 `/new-path`。
-- **Status**: 重定向的 HTTP 状态码。
- - `308`: 永久重定向。用于已永久迁移的内容。这是默认状态。
- - `307`: 临时重定向。当迁移是临时的时使用。
-
-
-
-
-
-
-添加重定向：
-1. 点击 **Add redirect**。
-2. 输入源路径和目标路径。
-3. 点击 **Save**。
-
-编辑或删除现有重定向：
-1. 将光标悬停在重定向上。
-2. 点击铅笔图标进行编辑，或点击垃圾桶图标进行删除。
-
-
- ## 添加分析和集成
-
-
-将分析和第三方工具连接到你的文档站点。
-
-通过以下方式追踪访客行为：
-
-* **Amplitude, Mixpanel, Heap**：产品分析平台
-* **Google Analytics, Google Tag Manager**：网站分析
-* **PostHog, Plausible, Fathom**：注重隐私的分析工具
-* **Segment, Hightouch**：客户数据平台
-* **Hotjar, LogRocket**：会话回放和热力图
-* **Microsoft Clarity**：用户行为分析
-* **Intercom**：客户沟通
-* **Clearbit, Koala**：访客识别
-
-其他集成：
-
-* **Telemetry**：启用或禁用使用数据遥测
-* **Cookies**：设置自定义 cookie 的 key 和 value 键值对
\ No newline at end of file
diff --git a/zh/editor/git-essentials.mdx b/zh/editor/git-essentials.mdx
deleted file mode 100644
index 7360483ab8..0000000000
--- a/zh/editor/git-essentials.mdx
+++ /dev/null
@@ -1,75 +0,0 @@
----
-title: "编辑器中的 Git 基础"
-sidebarTitle: "Git 基础"
-description: "了解 Mintlify 编辑器背后的 Git 版本控制概念，包括 branch、commit、拉取请求和合并工作流。"
-keywords: ["git", "版本控制", "Web 编辑器", "分支", "提交", "拉取请求（PR）", "PR"]
----
-
-Git 让你可以控制并跟踪文件的变更。Git 是 docs-as-code 工作流中的首选版本控制系统，在这种工作流中，你会像管理其他任何代码库一样管理文档。
-
-Web 编辑器会替你处理 Git 操作。理解几个关键概念有助于你更好地发挥编辑器的作用，并更高效地与团队协作。
-
-
- ## Git 为文档做什么
-
-
-Git 会跟踪对文档所做的每一次更改。它会记录更改了什么、是谁更改的、何时更改的，以及为什么更改。这意味着你可以：
-
-- 查看任意页面的完整历史记录。
-- 通过回退到先前版本来撤销更改。
-- 在不影响线上站点的情况下进行更新。
-- 在更改上线之前先进行审查。
-
-你的文档存储库是构成文档站点的文件及其历史记录的集合。Web 编辑器会连接到此存储库，以同步并发布你的内容。
-
-
- ## 关键概念
-
-
-这些是你在使用 Web 编辑器时最常接触到的 Git 概念。
-
-
- ## 编辑器如何映射到 Git
-
-
-在 Web 编辑器中的每一次发布操作都对应一次 Git 操作。
-
-| 你在编辑器中的操作 | 背后对应的 Git 操作 |
-|---|---|
-| 编辑页面 | 更改会自动保存到 Mintlify 服务器（尚未进行 Git 提交） |
-| 切换 branch | 切换到所选的 branch |
-| 在部署用分支上发布 | 将更改提交到你的存储库并触发一次部署 |
-| 在功能 branch 上发布 | 提交更改并创建一个拉取请求 |
-| 外部 push 或 CLI 更新 | 传入的更改会自动同步到编辑器中 |
diff --git a/zh/editor/index.mdx b/zh/editor/index.mdx
index 309d49cde2..d21a4ec012 100644
--- a/zh/editor/index.mdx
+++ b/zh/editor/index.mdx
@@ -1,66 +1,102 @@
---
title: "编辑器概览"
sidebarTitle: "概览"
-description: "在浏览器中创建、编辑和发布文档，支持团队实时协作、自动保存、实时预览以及与 Git 持续同步。"
-keywords: ["editor", "visual", "collaborative", "web editor"]
+description: "使用 Mintlify 编辑器在浏览器中创建、编辑和发布内容。支持实时协作和持续的 Git 同步。"
+keywords: ["web editor", "git", "branches", "commits", "pull requests"]
---
-
+
+使用编辑器在浏览器中撰写和发布文档。编辑器采用 docs-as-code 工作流，你的所有更改都由 Git 保存。你的工作会以 commit 的形式保存在仓库中，编辑器会替你处理 Git 操作。
-编辑器让你的内容与 Git 仓库保持同步，并让整个团队可以实时协同编辑。
+打开[仪表板](https://app.mintlify.com)时会默认加载编辑器。组织中的任何成员都可以打开编辑器，但具体能执行哪些操作取决于你的[角色](/zh/dashboard/roles)。Admins 和 editors 可以编辑和发布。Viewers 可以浏览内容，并留下[评论和建议](/zh/editor/collaborate)。
-
- ## 打开编辑器
-
+
-在 Mintlify 仪表板中，通过 [Editor](https://app.mintlify.com/editor) 标签页打开编辑器。你所在组织的任何成员都可以打开编辑器；你在编辑器内能做什么取决于你的[角色](/zh/dashboard/roles)。Admins 和 editors 可以编辑和发布，viewers 可以浏览内容，并留下[评论](/zh/editor/comments)或[建议](/zh/editor/suggestions)。
+## 编辑器的工作方式
-
- 如果编辑器与你的仓库出现不同步的情况，请使用 [Reset editor](/zh/editor/settings#reset-editor) 强制从 Git 重新同步。例如，文件树为空，或即使文件确实存在于你的部署分支上仍显示 `Unable to find docs.json`。
+ 如果编辑器看起来与仓库不同步，请使用[重置编辑器](/zh/editor/settings#reset-editor)强制重新同步。例如，文件树为空，或者在文件确实存在于 deployment branch 上时仍出现 `Unable to find docs.json` 错误。
-**发布会写入 Git。** 当你发布时，编辑器会将你的更改提交到你的仓库。在部署 branch 上，这会立即更新你的线上站点。在功能 branch 上，则会创建一个拉取请求。
+
- ## 编辑器的工作原理
-**更改自动保存。** 你在输入时，编辑器会自动保存你的工作。你的更改会在不同标签页、设备以及网络中断之间保持不变。只有在你发布时更改才会上线。
+**更改会自动保存，但保存不等于发布。** 在你输入时，编辑器会保存你的工作。你的更改会在标签页、设备和网络中断之间保留。若要让更改出现在已发布的站点上，你必须[发布](/zh/editor/publish)它们。
+
+**发布会写入 Git。** 发布时，编辑器会把你的更改提交到仓库。如果你发布到 deployment branch，已发布的站点会立即更新。在 feature branch 上，你可以选择发布时是立即更新站点，还是打开一个 pull request 供人审阅。
+
+**Git 保持同步。** 当有人向你的仓库推送更改时，这些更改会自动出现。你无需 pull 或刷新页面。编辑器会合并没有冲突的更改，并标记出需要你处理的部分。
-**Git 持续保持同步。** 当他人从编辑器之外向你的仓库推送更改时，这些更改会自动出现在编辑器中。你无需拉取或刷新。编辑器会自动合并无冲突的更改，并突出显示需要你关注的内容。
+**你的团队可以共同编辑。** 多人可以同时编辑同一个页面，实时光标会显示每个人正在处理的位置。评论和建议对所有人可见。
-**团队协同编辑。** 多人可以同时编辑同一个页面。实时光标会显示谁在哪里进行编辑。
+## 编辑器布局
-
- 了解 branch 和保护规则如何决定你在发布时发生的行为，以及如何管理拉取请求审查流程。
-
+
+
+
+
-
- 留下反馈、提出问题并与团队讨论更改。
-
+* **顶部栏**：使用顶部栏选择你要工作的分支、使用智能体、预览和发布更改。
+* **侧边栏**：使用侧边栏选择要编辑的页面、创建新页面并管理站点结构。
+ * **Home**：项目的文件树。**Personal** 中的页面仅你自己可见。**Workspace** 中的页面对你的组织公开。
+ * **Publishing**：站点的导航结构。按照你希望页面在站点上呈现的方式来组织它们。
-
- 提出团队成员可以审阅、接受或拒绝的更改建议。
-
+
- 配置站点品牌、配色和功能。
-
+**可视化模式**会在你输入时渲染页面。按 / 打开组件菜单并插入组件。
-
- 使用键盘快捷键加快你的工作流程。
-
+**source 模式**让你直接访问 MDX，适合精确控制组件属性和 frontmatter。
+
+两种模式编辑的是同一个文件。使用 Cmd + Shift + S（macOS）或 Ctrl + Shift + S（Windows）在两者之间切换。
+
+有关可插入的组件，请参阅[组件](/zh/components)。有关 MDX 语法，请参阅[文本格式](/zh/create/text)和[代码格式](/zh/create/code)。
+
+
+
+ 某一时刻更改的保存快照，并附有说明更改内容的消息。发布会创建一个 commit。
+
+
+ 一条独立的工作线。已发布的站点由 **deployment branch** 构建，通常是 `main`。其他分支（有时称为 **feature branch**）让你在不影响已发布站点的情况下工作。在你合并之前，feature branch 上的内容不会上线。
+
+
+ 把一个分支合并到另一个分支的提议，便于团队在更改上线前进行审阅。团队可以在 GitHub、GitLab 或 Bitbucket 中审阅并合并 pull request，也可以[在编辑器中](/zh/editor/review)完成。
+
+
+ 把一个分支的更改合并到另一个分支。合并到 deployment branch 会发布这些更改。
+
+
+ 两个分支对相同的行做了不兼容的更改。编辑器会提示你选择保留哪个版本，以便在合并前解决冲突。
+
+
+ 某个文件两个版本之间的比较。发布之前，编辑器会显示待处理更改的 diff。
+
+
+
+| 编辑器中的操作 | Git 操作 |
+|---|---|
+| 编辑页面 | 自动保存。尚未创建 commit。 |
+| 在 deployment branch 上发布 | `git commit` 和 `git push`，并触发部署。 |
+| Save in branch | 在当前 feature branch 上执行 `git commit`。 |
+| Create pull request | 执行 `git push` 并针对 deployment branch 打开一个 pull request。 |
+| Merge and publish | 合并 pull request 并触发部署。 |
+| 创建分支 | `git checkout -b ` |
+| 切换分支 | `git checkout ` |
+| 外部 push 或 CLI 更新 | 传入的更改通过三方合并同步到编辑器中。 |
diff --git a/zh/editor/keyboard-shortcuts.mdx b/zh/editor/keyboard-shortcuts.mdx
index 4198422b1e..ca6037d123 100644
--- a/zh/editor/keyboard-shortcuts.mdx
+++ b/zh/editor/keyboard-shortcuts.mdx
@@ -1,27 +1,38 @@
---
title: "键盘快捷键"
description: "查看 Mintlify 网页编辑器的完整键盘快捷键列表，包括文本格式、导航和编辑命令。"
-keywords: ["编辑器", "快捷键", "键盘", "快捷方式"]
+keywords: ["editor", "keys", "keyboard", "shortcuts"]
---
-在 Web 编辑器中使用键盘快捷键可以更快速地进行导航和编辑。编辑器支持常见的快捷键，如复制、粘贴、撤销和全选，以及下方列出的其他快捷键。
+使用键盘快捷键可以在网页编辑器中更快地浏览和编辑。除下列快捷键外，编辑器还支持复制、粘贴、撤销和全选等常用快捷键。
-
- ## 探索编辑器
-
+
+
-
-
- 添加新页面和更新现有页面所需的一切。
-
+## 可视化模式与 source 模式
-
- 重新排序页面并管理站点结构。
-
+
-
+
+## Git 概念
+
+
+
+了解一些 Git 概念有助于你更好地使用编辑器。
+
+
- ## 可视化模式
-
+
-在可视化模式下，你可以使用以下快捷键进行编辑。
+## 全局快捷键
-
+无论处于哪种模式，这些快捷键都可用。
+
| 命令 | macOS | Windows |
| :--- | :--- | :--- |
| **搜索文件和内容** | Cmd + K | Ctrl + K |
+| **显示或隐藏 AI 助手**（未在编辑文本时） | Cmd + I | Ctrl + I |
+| **在可视化模式与 source 模式之间切换** | Cmd + Shift + S | Ctrl + Shift + S |
+| **显示全部文件**（包括 dotfile 和非内容文件） | Cmd + Shift + . | Ctrl + Shift + . |
+
+
+
+## 可视化模式
+
+
+
+在可视化模式下编辑时使用这些快捷键。
- ### 文本格式化
+
+### 文本格式
+
| 命令 | macOS | Windows |
@@ -35,19 +46,25 @@ keywords: ["编辑器", "快捷键", "键盘", "快捷方式"]
| **上标** | Cmd + . | Ctrl + . |
- ### 标题
+
+### 标题
+
| 命令 | macOS | Windows |
| :--- | :--- | :--- |
| **正文** | Cmd + Option + 0 | Ctrl + Alt + 0 |
-| **一级标题** | Cmd + Option + 1 | Ctrl + Alt + 1 |
-| **二级标题** | Cmd + Option + 2 | Ctrl + Alt + 2 |
-| **三级标题** | Cmd + Option + 3 | Ctrl + Alt + 3 |
-| **四级标题** | Cmd + Option + 4 | Ctrl + Alt + 4 |
+| **标题 1** | Cmd + Option + 1 | Ctrl + Alt + 1 |
+| **标题 2** | Cmd + Option + 2 | Ctrl + Alt + 2 |
+| **标题 3** | Cmd + Option + 3 | Ctrl + Alt + 3 |
+| **标题 4** | Cmd + Option + 4 | Ctrl + Alt + 4 |
+| **标题 5** | Cmd + Option + 5 | Ctrl + Alt + 5 |
+| **标题 6** | Cmd + Option + 6 | Ctrl + Alt + 6 |
- ### 列表和区块
+
+### 列表和块
+
| 命令 | macOS | Windows |
@@ -56,25 +73,29 @@ keywords: ["编辑器", "快捷键", "键盘", "快捷方式"]
| **引用块** | Cmd + Shift + B | Ctrl + Shift + B |
- ### 内容操作
+
+### 内容操作
+
| 命令 | macOS | Windows |
| :--- | :--- | :--- |
-| **为选中文本添加链接** | Cmd + K | Ctrl + K |
-| **插入换行** | Cmd + Enter | Ctrl + Enter |
-| **对高亮文本添加评论** | Cmd + Shift + M | Ctrl + Shift + M |
-| **切换建议模式** | Cmd + Shift + E | Ctrl + Shift + E |
+| 为所选文本**添加链接** | Cmd + K | Ctrl + K |
+| **添加换行** | Cmd + Enter | Ctrl + Enter |
+| **对高亮文本发表评论** | Cmd + Shift + M | Ctrl + Shift + M |
+| **开启或关闭建议模式** | Cmd + Shift + E | Ctrl + Shift + E |
| **组件菜单** | / | / |
-| **表情符号选择器** | : + 关键词 | : + 关键词 |
+| **表情选择器** | : + 关键词 | : + 关键词 |
- ### 智能替换
+
+### 智能替换
+
-编辑器在你输入时，会自动将某些字符序列转换为排版符号。编辑器会跳过代码块和行内代码中的替换。
+在你输入时，编辑器会自动把某些字符序列转换为排版符号。编辑器会跳过代码块和行内代码中的替换。
-| 类型 | 结果 |
+| 输入 | 结果 |
| :--- | :--- |
| `->` | → |
| `<-` | ← |
@@ -83,38 +104,56 @@ keywords: ["编辑器", "快捷键", "键盘", "快捷方式"]
| `>=` | ≥ |
| `!=` | ≠ |
-
- ## Markdown 模式
+
- 实时预览适用于公开站点和受 Mintlify 身份验证保护的站点。对于需要身份验证的站点，编辑器会自动在预览中完成登录。
-
-
-
-
-
-
-
-
- 某些元素不能嵌套在其他元素中。例如，选项卡不能嵌套在分组中。编辑器会阻止你创建无效的组合。
-
-
-
-
-为你的内容选择合适的结构：
-
-- **Pages** — 独立的文档文件。导航的核心构建块。
-- **Groups** — 将相关页面聚合在一起的可折叠区段。可以嵌套在其他分组中。
-- **Tabs** — 站点顶部带有水平导航的顶级区段。当你有 API Reference 和 Guides 等不同领域时，请使用 Tabs。
-- **Anchors** — 位于侧边栏顶部的常驻项。适合快速访问外部资源或顶级区段。可设置为全局，以在每个页面上显示。
-- **Dropdowns** — 位于侧边栏顶部的可展开菜单。相对于 Tabs，是一种更轻量的替代方案，适用于多个相关区段。
-- **Menus** — 选项卡内的下拉导航项，可直接链接到特定页面。
-- **Products** — 多个不同产品文档集的切换器，每个产品都有自己的导航结构。
-- **Versions** — 多个并行文档版本的切换器。
-- **Languages** — 多语言文档的切换器。
-
-
+
+## Source 模式
+
-Markdown 模式使用 Monaco 编辑器，并支持 VS Code 标准键盘快捷键。
+Source 模式使用 CodeMirror。除下列快捷键外，大多数常见的代码编辑器快捷键都可用。
+
+
| 命令 | macOS | Windows |
| :--- | :--- | :--- |
| **搜索文件** | Cmd + K | Ctrl + K |
-| **查找** | Cmd + F | Ctrl + F |
+| **在页面内查找** | Cmd + F | Ctrl + F |
- ### 编辑
+
+### 编辑
+
| 命令 | macOS | Windows |
| :--- | :--- | :--- |
-| **切换注释** | Cmd + / | Ctrl + / |
-| **缩进当前行** | Tab | Tab |
-| **减少当前行缩进** | Shift + Tab | Shift + Tab |
-| **上移当前行** | Option + ↑ | Alt + ↑ |
-| **下移当前行** | Option + ↓ | Alt + ↓ |
+| **加粗**（用 `**` 包裹） | Cmd + B | Ctrl + B |
+| **斜体**（用 `_` 包裹） | Cmd + I | Ctrl + I |
+| **注释或取消注释** | Cmd + / | Ctrl + / |
+| **全部折叠** | Cmd + Option + Shift + [ | Ctrl + Alt + Shift + [ |
+| **全部展开** | Cmd + Option + Shift + ] | Ctrl + Alt + Shift + ] |
+| **增加缩进** | Tab | Tab |
+| **减少缩进** | Shift + Tab | Shift + Tab |
+| **上移一行** | Option + ↑ | Alt + ↑ |
+| **下移一行** | Option + ↓ | Alt + ↓ |
| **复制当前行** | Shift + Option + ↓ | Shift + Alt + ↓ |
- ### 多光标
+
+### 多光标
+
+{/* vale Mintlify.WordList = NO */}
+
| 命令 | macOS | Windows |
| :--- | :--- | :--- |
-| **添加光标** | Option + 单击 | Alt + 单击 |
+| **添加光标** | Option + 点击 | Alt + 点击 |
| **在上方添加光标** | Cmd + Option + ↑ | Ctrl + Alt + ↑ |
-| **在下方添加光标** | Cmd + Option + ↓ | Ctrl + Alt + ↓ |
\ No newline at end of file
+| **在下方添加光标** | Cmd + Option + ↓ | Ctrl + Alt + ↓ |
+
+{/* vale Mintlify.WordList = YES */}
diff --git a/zh/editor/live-preview.mdx b/zh/editor/live-preview.mdx
deleted file mode 100644
index 9ec0d7d426..0000000000
--- a/zh/editor/live-preview.mdx
+++ /dev/null
@@ -1,61 +0,0 @@
----
-title: "实时预览"
-description: "在编辑时实时预览你的文档站点，持续查看内容、导航和站点配置的更改；了解如何在编辑器或新标签页中打开实时预览，并使用 Site settings 检查器调整配置、查看渲染结果、比较预览部署，以及在发布前检查更改。适合在编辑过程中获得即时反馈，帮助你在共享预览前验证页面显示效果和站点设置是否符合预期。"
-keywords: ["editor", "preview", "live preview"]
----
-
-在编辑时预览你的站点。实时预览会准确呈现页面发布后的效果，并在你对内容、导航和配置进行修改时实时更新。
-
-
- ## 打开实时预览
-
-
-点击顶部栏中的
-
-
-
-
- ## 在实时预览中编辑站点设置
-
-
-在实时预览中编辑站点设置，查看这些设置如何影响渲染后的内容。
-
-1. 在编辑器中打开实时预览。
-2. 点击预览工具栏中的 **Site settings**。
-3. 选择配置分区并编辑设置。
-
-如果你将实时预览设置为在新标签页中打开，站点设置菜单将不可用。请在[编辑器设置](/zh/editor/settings)中关闭 **Open live preview in new tab**，以使用站点设置菜单。
-
-
- ## 在实时预览中向代理提问
-
-
-点击预览工具栏中的 **Ask agent**，在实时预览旁打开[编辑器代理](/zh/editor/agent)。只有编辑者和管理员可以在实时预览中使用代理。
-
-
- ## 实时预览与预览部署
-
-
-| | 实时预览 | 预览部署 |
-|---|---|---|
-| **速度** | 即时 | 需要构建 |
-| **访问方式** | 本地 URL，受保护站点会自动完成身份验证 | 可分享的 URL |
-| **使用时机** | 在编辑时查看更改 | 与团队共享以供审阅 |
-| **可用性** | 当编辑器打开时 | 只要该 branch 存在 |
-
-在编辑过程中使用实时预览以获得即时反馈。当你需要与团队共享更改，或在不同设备上测试时，请使用 [预览部署](/zh/editor/branching-and-publishing#preview-your-changes)。
diff --git a/zh/editor/media.mdx b/zh/editor/media.mdx
deleted file mode 100644
index 88f3f34011..0000000000
--- a/zh/editor/media.mdx
+++ /dev/null
@@ -1,100 +0,0 @@
----
-title: "添加媒体"
-description: "使用 Mintlify 网页编辑器内置的文件管理器，在文档页面中上传、管理和嵌入图片及其他媒体资源。"
-keywords: ["editor","media","images","assets"]
----
-
-
- ## 支持的文件类型
-
-
-* **图片**：PNG、JPG、JPEG、GIF、WebP（最大 20 MB）
-* **视频**：MP4、WebM (最大 20 MB)
-* **字体**：TrueType (TTF) 、WOFF、WOFF2
-* **其他**：PDF、ICO (网站图标)
-
-
- ## 在页面中添加媒体
-
-
-
- ### 拖放
-
-
-将媒体从你的电脑或资源管理器拖放到页面上。在可视化模式下，图片或视频会以内联形式插入。在 Markdown 模式下，编辑器会在你的光标位置插入路径。图片会保存到 `images/` 文件夹的根目录下，视频会保存到 `videos/` 文件夹的根目录下。
-
-
- ### 斜杠命令
-
-
-输入 /image 以打开图片菜单，或输入 /video 以打开视频菜单。上传新的媒体文件或从现有文件中进行选择。
-
-
- ### 嵌入
-
-
-输入 /embed 并粘贴 YouTube、Loom 或 Vimeo 的 URL。编辑器会自动识别提供方并生成对应的 iframe。在斜杠菜单中搜索 `youtube`、`yt`、`loom` 或 `vimeo` 也会显示 **Embed** 命令。
-
-对于其他嵌入内容，输入 /embed 并切换到 **手动嵌入** 以编写自定义 HTML。
-
-
- ### 上传文件
-
-
-使用侧边栏中的文件浏览器上传或搜索文件。将文件拖放到文件夹中，以便整理媒体资源。
-
-
-
-
-
-
-
-
- ## 格式化图片
-
-
-在可视编辑模式下插入图片后，将鼠标悬停在图片上，会显示一个带有格式选项的工具栏。
-
-- **浅色/深色预览**：在浅色和深色模式之间切换，以查看图片在每种主题下的显示效果。
-- **对齐方式**：将图片对齐方式设置为左对齐、居中、右对齐或全宽。
-- **Frame**：将图片包裹在 `` 组件中以添加边框和背景。
-- **设置**：替换图片或更新其 alt 文本（替代文本）。
-
-
- ## 管理资源
-
-
-
- ### 使用文件夹整理
-
-
-在文件资源管理器中点击 **+** 按钮创建新文件夹。在文件树中拖拽文件和文件夹以重新调整它们的结构。
-
-
- ### 重命名和编辑资源
-
-
-将鼠标悬停在资源上，点击 **...** 按钮，以重命名文件或更新其 alt 文本。
-
-
- ### 删除资源
-
-
-将鼠标悬停在某个资源上，然后点击
- ## 最佳实践
-
-
-- **使用描述性名称**：为文件使用清晰、具有描述性的名称。例如，将文件命名为 `api-dashboard-light.png`，而不是 `img1.png`。
-- **添加替代文本（alt text）**：为图像提供描述性的替代文本，以提升可访问性和 SEO（搜索引擎优化）。
-- **通过文件夹进行组织**：将相关资源分组管理，例如浅色和深色模式的不同版本，或某个特定功能区域使用的资源。
-- **使用合适的格式**：PNG 适用于带透明度的图形，JPG 适用于照片，SVG 适用于图标和徽标（你无法通过编辑器上传 SVG 文件，但可以通过 Git 将其添加到存储库中）。
\ No newline at end of file
diff --git a/zh/editor/navigation.mdx b/zh/editor/navigation.mdx
deleted file mode 100644
index 9587bbe6fd..0000000000
--- a/zh/editor/navigation.mdx
+++ /dev/null
@@ -1,49 +0,0 @@
----
-title: "组织导航"
-description: "通过在 Mintlify Web 编辑器中拖放，重新排序页面、添加分组并管理文档侧边栏结构，无需修改 docs.json。"
-keywords: ["编辑器", "导航", "侧边栏", "结构"]
----
-
-使用导航侧边栏来组织你的文档。你在编辑器中所做的更改会在发布时同步到你的仓库 —— 你无需手动修改 `docs.json`。
-
-
-
-在导航树底部点击 **Add new**，可在根级别添加一个新元素。要在另一个元素内嵌套添加元素，请点击该元素旁边的
- ## 配置元素
-
-
-将光标悬停在任意导航元素上，然后点击齿轮图标即可设置：
-
-- **Title**：在侧边栏中显示的标签。
-- **Icon**：标签旁边的视觉标记。
-- **Tag**：用于突出显示该项的徽章，如 “NEW” 或 “BETA”。
diff --git a/zh/editor/pages.mdx b/zh/editor/pages.mdx
index a34d72dab5..7fe86c5e31 100644
--- a/zh/editor/pages.mdx
+++ b/zh/editor/pages.mdx
@@ -1,188 +1,94 @@
---
title: "创建和编辑页面"
-description: "在 Mintlify Web 编辑器中创建和编辑文档页面，管理文件与文件夹，使用可视化或 Markdown 模式编辑内容，配置页面设置，插入图片、视频和外部媒体。了解如何搜索文件、管理未列出的页面、调整导航顺序、设置页面标题、Slug、描述和布局，以及使用版本历史查看页面保存记录。"
-keywords: ["编辑器","内容","页面","文件","版本历史"]
+sidebarTitle: "编辑内容"
+description: "在编辑器中创建页面、编辑内容、添加媒体、组织导航，以及恢复页面的历史版本。"
+keywords: ["editor", "content", "pages", "navigation", "version history", "media", "images", "private pages"]
---
-
-
-在左侧面板的 **Navigation** 标签页中浏览文档页面。
-
-* 点击导航元素以展开或折叠。
-* 点击页面将在编辑器中打开它。
-* 点击搜索 icon，或按下 Cmd + K (macOS) 或 Ctrl + K (Windows) ，搜索文件和内容。搜索会在文件名和页面内容中查找匹配项。
-* 点击工具栏中的隐藏侧边栏按钮以折叠侧边栏，为编辑器留出更多空间。
+
-
- 导航标签页按页面标题列出页面。文件标签页按页面的文件名和扩展名列出页面。
-
+## Home 与 Publishing
-
- API 规范文件（OpenAPI 和 AsyncAPI）在 Web 编辑器中为只读。你可以查看其内容，但无法直接编辑。要更新规范文件，请使用你偏好的代码编辑器进行编辑，然后将更改推送到你的文档仓库。
-
+Home 默认会隐藏部分文件，包括 `docs.json`、名称以点开头的文件和文件夹、没有扩展名的文件、像 `README.md` 这样的全大写 Markdown 文件，以及 `.css`、`.js`、`.jsx`、`.mjs`、`.cjs` 和 `.pdf` 文件。若要查看全部文件，请启用 [Show all files](/zh/editor/settings#appearance)，或按 Cmd + Shift + .（macOS）或 Ctrl + Shift + .（Windows）。
-
- 
+
- ## 创建新页面
-1. 在要添加页面的导航区域中，点击
- ## 编辑内容
-
+**Home** 是你的工作区，显示仓库中的内容文件，包括你的私有页面，无论它们是否出现在已发布的站点上。
-使用工具栏中的开关在可视化模式和 Markdown 模式之间切换。切换模式时，Web 编辑器会保存你的更改。
+**Publishing** 是你已发布的站点，显示访问者看到的导航以及站点设置。
-
+
- 
-
+## 创建页面
-
-
+## 创建页面
-
- ### 可视模式
-在编辑内容时实时预览其发布后的效果。编辑器会使用你的浏览器内置的拼写检查功能，在你输入时高亮显示拼写错误的单词。
-
-* **添加文本**：在编辑器中输入，查看文本在发布后如何呈现。
-* **格式化文本**：使用工具栏将文本加粗、设置为斜体或应用其他格式。
-* **添加组件**：按下 / 打开组件菜单并选择组件。
-* **添加图片**：从 / 菜单中使用 image 组件，或输入 /image。
-* **添加视频**：输入 /video 来上传或选择视频。
-* **添加嵌入内容**：输入 /embed 并粘贴 YouTube、Loom 或 Vimeo 的 URL 即可嵌入视频，或切换到 **手动嵌入** 以编写自定义 HTML。详情参见 [Add media](/zh/editor/media)。
-* **添加 Mermaid 图表**：输入 /mermaid 来插入带有交互式预览、缩放/平移控件、全屏模式和代码编辑器的 Mermaid 图表。
-* **添加片段**：输入 /snippet 来搜索并插入可复用片段。编辑器会自动添加所需的 import 语句。
-* **添加数学公式**：输入 /inline-math 以插入行内 LaTeX 公式，或输入 /block-math 以插入居中的块级公式。请先在站点设置中[启用 LaTeX](/zh/editor/configurations)。
-* **添加 Prompt 块**：输入 /prompt 来插入带有复制操作的 AI Prompt 模板。
-* **编辑表格**：当光标位于表格内部时，使用浮动工具栏添加或删除行和列，或合并单元格。
-* **插入表情符号**：输入 : 后跟关键词即可打开表情符号选择器。使用方向键在网格中导航，然后按 Enter 插入所选表情符号。选择器支持按表情符号名称、标签和短代码进行搜索。
-* **插入链接**：选中文本并按 Cmd + K，或将页面从导航树中拖入编辑器，以使用该页面标题创建链接。
-* **链接到其他页面**：在导航树中右键点击某个页面，选择 **Copy link**，然后将链接粘贴到内容中。编辑器会识别同一文档中其他页面的链接，并自动将其转换为内部链接。即使之后移动或重命名目标页面，粘贴的链接仍然有效。
-
-完整的可用组件列表请参见 [Components](/zh/components)。
-
-
- ### Markdown 模式
-
+若要把页面添加到导航中，请在你想放置该页面的导航元素上点击
-* **直接编辑 MDX**：编写 MDX 和 Markdown 语法，以精确控制内容。
-* **组件属性**：设置组件属性和配置。
-* **Frontmatter**：编辑文件顶部的页面元数据。
+## 添加媒体
-有关 MDX 语法的更多信息，请参阅 [格式化文本](/zh/create/text) 和 [格式化代码](/zh/create/code)。
-
-
- ### 版本历史
-使用版本历史查看正在编辑的页面的已保存版本。
-
-当编辑器保存的内容与最近记录的版本不同时，Mint 会记录新条目。保存未更改的内容不会创建重复条目。保存后的页面也可以为空。
-
-版本历史按日期对条目进行分组。每条记录显示作者和保存时间。Mint 将最新记录标记为 **Current**。
-
-要打开版本历史：
-
-1. 在编辑器中打开文档页面。版本历史不适用于 `docs.json`。
-2. 在右上角点击 **More options**。
-3. 选择 **Version history**。
-
-当页面支持版本历史时，你还可以点击编辑器标题栏中的 **Edited** 时间戳以打开抽屉。对于不支持版本历史的页面，该时间戳仍不可交互。
-
-抽屉显示当前页面的版本。公开页面的版本历史仅包含当前分支，私有页面的版本历史则包含所有分支的记录。查看者可以查看和比较私有页面的已保存版本，编辑者和管理员可以恢复这些版本。点击 **Show more versions** 加载更早的记录。
+输入 /image 或 /video 上传文件，或选择仓库中已有的文件。你也可以把文件从电脑拖放到页面上。若要复用媒体，请把图片或视频从导航树拖到页面上。
-当你拥有页面编辑权限时，较早的版本会显示 **Restore** 操作。点击 **Restore** 并确认，即可使用该保存版本替换当前页面内容。此操作会覆盖未保存的更改。
+- 上传的文件会保存到 `images/` 和 `videos/` 文件夹，并随下次发布一起提交。
+- 支持的格式为 PNG、JPG、JPEG、GIF、WebP、SVG、MP4 和 WebM。
+- 若要在浅色和深色模式下显示不同的图片，请将鼠标悬停在已插入的图片上并使用 **Light/dark variants**。
+- 输入 /embed 并粘贴 YouTube、Loom 或 Vimeo 的 URL 即可生成 iframe。其他情况请切换到 **Manual embed** 以编写自定义 HTML。
-Restore 会将所选快照应用到当前页面。对于公开页面，它会恢复当前分支上的页面。对于私有页面，它会更新共享的私有内容。
+有关图片格式和 Frame 组件的用法，请参阅[图片与嵌入内容](/zh/create/image-embeds)。
-要将较早的保存版本与当前页面进行比较，请点击该版本所在的行。编辑器会打开 diff 视图，将保存版本作为基准，并与当前页面内容进行比较。活动行会显示 **Viewing**。再次点击活动行即可退出比较并返回编辑。
+
-被阻止的部署分支和 **Current** 版本不提供 Restore 操作。
+## 组织导航
-
+
+ 有些元素无法嵌套在其他元素中。例如，tabs 不能嵌套在 groups 中。编辑器会阻止无效的组合。
+
- 
-
+若要修改页面的标题、slug、描述或 layout，请从导航树中打开该页面的设置。有关各项设置的更多信息，请参阅[页面](/zh/organize/pages)。
-
-
-控制页面在站点导航侧边栏中的显示方式。
+
- ## 配置页面
-通过配置页面设置，可以控制页面在导航、搜索结果以及站点布局中的显示方式。
+在 Navigation 视图中拖动元素即可重新排序或嵌套。发布时，编辑器会把你的更改写入 `docs.json`。
-将鼠标悬停在页面上，然后单击齿轮 icon。你也可以右键单击文件并选择 **Settings**。
+- **Groups**：可折叠的分区，用于聚合相关页面。可以嵌套在其他 group 中。
+- **Tabs**：带水平导航的顶级分区。适用于 API 参考、指南等相互独立的区域。
+- **Anchors**：位于侧边栏顶部的常驻条目。适合外部资源。可以设为全局，从而出现在每个页面上。
+- **Dropdowns**：位于侧边栏顶部的可展开菜单。相比 tabs 更轻量的替代方案。
+- **Menus**：tab 内部的下拉条目，直接链接到特定页面。
+- **Products**：用于切换多套产品文档，每套都有各自的导航。
+- **Versions**：用于切换同时存在的多个文档版本。
+- **Languages**：用于切换多语言文档。
-
-
+
-
+若要修改页面的标题、slug、描述或 layout，请从导航树中打开该页面的设置。有关各项设置的更多信息，请参阅[页面](/zh/organize/pages)。
-
-
-控制页面在站点导航侧边栏中的显示方式。
+
-* **标题**：设置主标题。会显示在导航、浏览器标签页和搜索结果中。
-* **Slug**：设置页面的 URL 路径。slug 默认是相对于存储库根目录且不包含文件扩展名的路径。例如，`guides/getting-started.mdx` 会变为 `guides/getting-started`。更改 slug 会重命名并移动文件，以匹配新路径。
-* **侧边栏标题**：当完整标题在侧边栏中过长时，可以在导航中显示更短的文本。
-* **Icon**：在页面旁边添加视觉标记，帮助用户快速识别。
-* **外部 URL**：链接到外部站点，而不是某个页面。使用此选项将外部资源添加到你的导航中。
+## 版本历史
-
- ### 为搜索和分享进行优化
-帮助用户找到你的页面，并优化页面在被分享时的展示效果。
+版本历史让你查看并恢复页面此前保存的版本。`docs.json` 不支持版本历史。
-* **Description**：撰写简短摘要。会显示在搜索结果和 SEO (搜索引擎优化) 元标签中。
-* **Keywords**：添加相关搜索词，帮助用户更容易发现此页面。
-* **OG Image URL**：为社交媒体分享和链接预览设置自定义预览图片。
+Viewers 可以查看和比较私有页面的已保存版本。Editors 和 admins 可以恢复这些版本。
-
- ### 控制页面布局
-
-
-根据你的内容需求选择页面的展示方式。
+只要内容与最近一次记录的版本不同，编辑器就会记录一条新条目。版本历史按分支划分，只能查看当前分支的版本历史。
-* **标准布局** (`default`) ：带有侧边栏导航和目录的默认页面。
-* **全宽布局** (`wide`) ：隐藏目录，为表格、图表或其他内容提供更宽的布局。
-* **居中布局** (`center`) ：隐藏侧边栏和目录，以提升更新日志等文本较多页面的可读性。
-* **自定义宽度** (`custom`) ：仅保留顶部导航栏的极简布局，适用于着陆页或其他特殊布局。
+若要查看版本历史，请点击页面右上角的
- ## 管理页面
-
+如果你恢复某个版本，页面上未保存的更改会被覆盖。恢复公开页面时，只会在当前分支上恢复。恢复私有页面时，会在所有分支上恢复。
-
- ### 移动页面
-
+
-拖放页面即可在导航中调整顺序，或在文件树中在不同文件夹之间移动文件。
+## 私有页面
-
+ 你无法把 workspace 中的内容移回 **Private** 分区。把私有页面变为公开是不可逆的操作。
+
diff --git a/zh/editor/publish.mdx b/zh/editor/publish.mdx
index 87d9012073..98b75d8814 100644
--- a/zh/editor/publish.mdx
+++ b/zh/editor/publish.mdx
@@ -1,121 +1,96 @@
---
-title: "在 Web 编辑器中发布更改"
+title: "发布更改"
sidebarTitle: "发布"
-description: "保存你的工作并发布你对文档站点的更改。"
-keywords: ["编辑器", "发布", "更改", "branches", "拉取请求（PR；亦称“合并请求”/Merge Request）"]
+description: "把编辑器中的更改发布到已发布的站点。分支和保护规则决定了发布时会发生什么。"
+keywords: ["publish", "branch", "git", "commit", "conflicts", "deploy", "pull request"]
---
-
- 当你从编辑器创建拉取请求时，Mintlify agent 会根据你的更改自动生成标题和描述。你可以在创建拉取请求之前编辑生成的标题和描述。
-
-
-**直接发布**：如果没有保护规则，你的更改会在发布时合并到部署用分支并立即部署。
+
+ 如果你看不到分支选择器或 **Publish** 按钮，说明你的 deployment 已启用[自动发布](#auto-publish)，你的更改会自动上线。
+
-| branch 类型 | branch 保护 | 发布工作流 |
-|-------------|-------------------|------------------------------|
-| 部署用分支 | 无 | 提交并部署更改 |
-| 部署用分支 | 需要拉取请求 | 创建一个拉取请求 |
-| 功能分支 | 无 | 将更改合并到部署用分支并部署更改 |
-| 功能分支 | 需要拉取请求 | 创建一个拉取请求 |
+
- ### 重命名页面
-在文件浏览器中，右键点击文件并选择 **Rename**。编辑器会自动保留文件扩展名，你只需输入页面名称即可。
-
-
- ### 复制页面
-
-
-右键单击该页面，然后选择 **Duplicate**。
-
-
- ### 删除页面
-
-
-右键点击页面并选择 **Delete**。删除页面后，它会自动从导航中移除。
-
-
- ### 隐藏页面
-
+把私有页面或文件夹拖入 workspace 后，协作者会立即可以访问它，但它不会被添加到站点导航中。
-要在不删除文件的情况下将页面从导航中移除，请在页面设置中启用 **Hidden** 开关。该隐藏页面仍保留在你的存储库中，用户仍然可以通过直接访问该页面的 URL 来访问它。你可以在页面设置中取消隐藏页面，或将其添加到 `docs.json` 的导航中。
+
- ## 发布工作流
-
-
-编辑器支持两种发布文档更新的工作流程。你使用的工作流程取决于存储库的 branch 保护规则以及你正在使用的 branch。
-
-**创建拉取请求**：如果你的存储库具有需要审核的 branch 保护规则，要求在更改合并到部署用分支之前必须先创建拉取请求，那么在你发布更改时，编辑器会创建一个拉取请求（PR；亦称”合并请求”/Merge Request）。
+编辑时你的更改会自动保存，但只有在你发布之后才会出现在已发布的站点上。发布时会发生什么，取决于你在哪个分支上工作，以及该分支是否要求使用 pull request。
-
-
- 在你的 Git 服务提供商中配置 branch 保护规则以要求拉取请求。请参阅 GitHub 文档中的 [About protected branches](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches) 或 GitLab 文档中的 [Protected branches](https://docs.gitlab.com/user/project/repository/branches/protected/)。
-
+## 待处理更改
-
-
-
+
- ## 保存更改
-在编辑过程中，编辑器会跟踪你的更改。
+编辑器会把以下内容记录为待处理更改：
-- 新建或删除的文件。
-- 页面内容的修改。
-- 导航结构的更改。
-- 媒体文件的上传和整理。
-- 配置更新。
+- 页面中的内容编辑
+- 新增或删除的页面
+- 导航结构的更改
+- 上传的媒体文件
+- 配置更新
-当你在部署用分支上工作时，你的更改会自动保存。
+如果没有待处理更改，编辑器会禁用发布和保存操作。
-
-
-
-
+
-当你在功能分支上工作时，请将更改保存到该分支。
+## 发布时会发生什么
-
-
-
-
-
-若要放弃更改，请在文件更改下拉菜单中文件名旁单击 **Undo changes**。
-
-Deployment branch | 无 | **Publish** 直接发布到已发布的站点 |
+| Deployment branch | 要求 pull request | **Create branch** 把更改移动到新分支 |
+| Feature branch | 无 | **Save in branch**、**Create pull request** |
+| Feature branch | 要求 pull request | **Save in branch**、**Create pull request** |
-无法显示差异的文件（如图片或已删除的文件）会出现在列表中，但不可点击。
+- **Publish**：立即提交并把更改部署到已发布的站点。
+- **Save in branch**：把更改提交到 feature branch，但不合并到 deployment branch。
+- **Create branch**：当你位于受保护的 deployment branch 上时，把待处理更改移动到新的 feature branch。
+- **Create pull request**：打开一个以 deployment branch 为目标的 pull request。
-已变更的页面会在文件树中高亮显示，让你一眼就能看出 [automation](/zh/automations) 或团队成员改动了哪些文件。出现在分支差异中的未列出页面（unlisted pages），即使它们没有出现在站点导航中，也可以从发布菜单中打开。
+每个分支同一时间只能进行一次发布。如果同事正在向同一分支发布，请等待其发布完成后再重试。
-
+ Mintlify 完成构建和部署后，你的站点才会更新。这通常需要 30 秒到几分钟。请在[仪表板](https://app.mintlify.com)上查看部署状态。
+
-- 在控制台的 **Automation Runs** 页面，点击已完成运行上的 **Open in editor**。
-- 在 Slack 通知中，点击 **View changes** 链接。
+
-
-
-
-若要放弃更改，请在文件更改下拉菜单中文件名旁单击 **Undo changes**。
-
-
- ## 审查分支更改
-当你在功能分支上工作时，发布面板会在 **Saved in branch** 下显示你的分支与部署用分支之间的所有文件更改。这包括你保存的更改以及在同一分支上工作的任何团队成员保存的更改。
-
-点击列表中的文件可打开差异视图，显示分支与已发布内容之间的更改。文档文件以可视化差异方式打开，其他文件类型以源代码差异方式打开。在发布之前，你可以使用此功能来审查分支上的所有更改。
+| 分支类型 | 分支保护 | 可用操作 |
+| --- | --- | --- |
+|
- ### 在编辑器中打开自动化运行
-
-
-当 [automation](/zh/automations) 打开一个 pull request 时，你可以直接从运行审查 UI 或其 Slack 通知跳转到编辑器，并切换到该自动化的分支：
+
-任一入口都会打开编辑器并切换到该自动化的分支，发布菜单中会预选已变更的页面，让你无需离开编辑器即可审查差异并合并或请求更改。
+## 何时使用分支
-
- Mintlify 构建并部署你已发布的更改后，你的线上文档站点会更新。这通常需要 30 秒到几分钟。你可以在你的 [dashboard](https://dashboard.mintlify.com) 上查看更改的部署状态。
+ 在有未发布更改时创建或切换分支，系统会询问你是把这些更改一起带走，还是留在原处。留下的更改会保留在原分支上。
-## 解决冲突
+
- ## 发布更改
-点击工具栏中的 **Publish**。根据你的工作流，你的更改会立即部署，或者在你的 Git 服务提供商中为你创建一个拉取请求（PR；亦称“合并请求”/Merge Request），供你合并。如果你在功能分支上，请在发布前先保存更改。
+如果你不使用基于 Git 的工作流，可以直接在 deployment branch 上编辑。如果每项更改在上线前都需要审阅，请创建分支。
-如果没有待处理的更改，或者当前分支已经有打开的拉取请求（PR；亦称“合并请求”/Merge Request），则 **Publish** 按钮不可点击。
+若要创建分支，请点击编辑器工具栏中的分支名称，选择 **Create new branch**，输入名称，然后点击 **Create branch**。
-当你的 branch 和部署用分支对同一文件做了互不兼容的更改时，就会发生冲突。
+## 解决冲突
-
- ### 冲突产生的原因
-当你尝试合并对同一文件进行了不兼容更改的 branch 时，就会发生冲突。
+当你的分支与 deployment branch 对相同文件做了不兼容的更改时，就会产生冲突。例如，你和同事编辑了相同的行，或者把同一个文件移动到了不同位置。
-* 你和另一位团队成员在不同的 branch 上编辑了同一文件中的相同行。
-* 在一个 branch 中，文件被移动、重命名或删除，但在另一个 branch 中又以不同方式被修改。
+当有人从编辑器之外向仓库推送更改时，编辑器会自动应用不重叠的更改。如果远程更改与你的编辑影响页面的同一部分，编辑器会高亮显示该冲突。
+
+当冲突导致无法发布时，编辑器会显示警告。请按照提示选择每处冲突要保留的版本。
+
+
+
+## 提交签名
-
- ### 解决冲突
-当冲突导致无法执行发布或切换 branch 等操作时，编辑器会显示 Warning。要解决冲突，请按照编辑器中的提示选择要保留的更改。
+在[账户设置](https://app.mintlify.com/settings/account)中授权你的 GitHub 账户，即可用它签署 commit。未授权时，编辑器中的 commit 由 Mintlify GitHub App 签署。
+
+
+
+## 自动发布
-
+ 实时预览适用于公开站点，以及受 Mintlify 认证保护的站点。
+
+
+
+
+
+
+预览 URL 默认可公开访问。若要将访问权限限制为你的 Mintlify 组织成员，请在仪表板的 [Add-ons](https://app.mintlify.com/products/addons) 页面上启用预览认证。
+
+
+ 在 Git 提供方中配置分支保护规则，以强制要求使用 pull request。请参阅 GitHub 帮助中的 [About protected branches](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches)，或 GitLab 帮助中的 [Protected branches](https://docs.gitlab.com/user/project/repository/branches/protected/)。
+
+
+
- ## 提交签名
-在你的 [账户设置](https://dashboard.mintlify.com/settings/account) 中授权你的 GitHub 账号，即可用该账号对提交进行签名。若未完成授权，则由 Mintlify GitHub 应用为在网页编辑器中完成的提交进行签名。
+如果你的 deployment 启用了[自动发布](/zh/editor/settings#main-branch-autocommits)，在你停止输入后不久，编辑器就会提交到 deployment branch。分支选择器和 **Publish** 按钮会被隐藏，没有待处理状态，也没有审阅环节。
-将提交归属到你的账号有助于准确记录是谁对你的文档进行了更改。
\ No newline at end of file
+无论是否启用该设置，在编辑器中创建的 feature branch 上的编辑都会自动提交，但除非你把它们合并到 deployment branch，否则永远不会发布。
diff --git a/zh/editor/review.mdx b/zh/editor/review.mdx
new file mode 100644
index 0000000000..c3e1364930
--- /dev/null
+++ b/zh/editor/review.mdx
@@ -0,0 +1,131 @@
+---
+title: "审阅更改"
+sidebarTitle: "审阅"
+description: "在更改上线前进行预览，与团队共享，并在编辑器中批准和合并 pull request。"
+keywords: ["review", "preview", "live preview", "pull request", "approve", "merge", "diff"]
+---
+
+在更改进入已发布的站点之前先进行预览，然后无需离开编辑器即可审阅并合并 pull request。
+
+
+
+## 实时预览
+
+
+
+实时预览会在你编辑时渲染站点，无需构建步骤。点击顶部栏中的
+
+## 预览部署
+
+
+
+当你从 feature branch 打开 pull request 时，Mintlify 会构建一个预览部署：一个临时 URL，其中你的更改会完全按照发布后的样子呈现。每当你向该分支保存新的更改，预览都会重新构建。
+
+若要查找并共享该 URL，请点击工具栏中的 **Publish**。URL 格式为 `organization-branch-name.mintlify.site`。
+
+
+
+
+
+
+预览 URL 默认可公开访问。若要将访问权限限制为你的 Mintlify 组织成员，请在仪表板的 [Add-ons](https://app.mintlify.com/products/addons) 页面上启用预览认证。
+
+
+
+## 该使用哪种预览
+
+
+
+| | 实时预览 | 预览部署 |
+|---|---|---|
+| **速度** | 即时 | 需要构建 |
+| **访问方式** | 本地 URL | 可共享的 URL |
+| **适用场景** | 编辑过程中查看更改 | 与团队共享以供审阅 |
+| **可用时长** | 编辑器打开期间 | 只要该分支存在 |
+
+
+
+若要把同事引导到某个分支上的特定页面，请从浏览器地址栏复制 URL。任何有权访问你的 Mintlify 组织的人都可以在自己的编辑器会话中打开它。
+
+```text
+https://app.mintlify.com/{org}/{project}/editor/{branch}/~/{filepath}
+```
+
+例如：`https://app.mintlify.com/acme/docs/editor/main/~/guides/quickstart.mdx`
+
+
+
+## 审阅并合并 pull request
+
+
+
+当前分支存在打开的 pull request 时，发布菜单会显示一个审阅面板，其中包含：
+
+- pull request 的标题和描述
+- 源分支和目标分支
+- 已更改文件的数量
+- deployment branch 上的审批要求
+- 当前的审阅状态
+
+审阅者批准后，点击 **Merge and publish** 即可在编辑器中完成合并和部署。合并后，编辑器会把你切换回 deployment branch。
+
+
+
+### 在编辑器中批准
+
+
+
+对于 GitHub 仓库，审阅者无需离开编辑器即可批准打开的 pull request。如果你的账户有审阅权限，审阅面板中会出现 **Approve pull request** 按钮。状态会更新为 **Approved**，并且 **Merge and publish** 变为可用。
+
+如果你使用 GitLab 或 Bitbucket，请在对应的 Git 提供方中打开该 pull request 进行批准。
+
+
+
+### 合并前比较更改
+
+
+
+在发布菜单中点击任意已更改的文件，即可在 diff 视图中将其与已发布版本进行比较。可视化模式显示可视化 diff，source 模式显示文本 diff。无法显示 diff 的文件（例如图片或已删除的文件）会出现在列表中，但无法点击。
+
+出现在分支 diff 中的[隐藏页面](/zh/organize/hidden-pages)也可以从发布菜单中打开，即使它们并未出现在站点导航中。
+
+
+
+### pull request 的标题和描述
+
+
+
+如果你的组织要求使用 pull request，你可以在发布时输入标题和描述。如果其中任一项留空，编辑器会生成一个，列出你创建、更新、移动或删除的文件。若要控制其撰写方式，请设置 [PR 说明](/zh/editor/settings#pr-instructions)。
+
+如果你的分支存在未解决的评论线程，Mintlify 会把这些线程的摘要添加到 pull request 描述中。请参阅[协作](/zh/editor/collaborate#comments)。
+
+
+
+## 审阅自动化运行
+
+
+
+当[自动化](/zh/automations)打开 pull request 时，你可以在该自动化的分支上打开编辑器：
+
+- 在仪表板的 **Automation Runs** 页面中，点击已完成运行上的 **Open in editor**。
+- 在 Slack 通知中，点击 **View changes** 链接。
+
+这两种入口都会在自动化所在的分支上打开编辑器，并在发布菜单中预先选中被修改的页面，让你无需离开编辑器即可审阅 diff 并进行合并或请求修改。[智能体](/zh/editor/agent#continue-an-automation-run)会在旁边打开，并带有该自动化所做工作的上下文。
diff --git a/zh/editor/settings.mdx b/zh/editor/settings.mdx
index 4b0b4d69ae..e7164bfb2a 100644
--- a/zh/editor/settings.mdx
+++ b/zh/editor/settings.mdx
@@ -1,183 +1,139 @@
---
-title: "用于 AI 与发布的编辑器设置"
-description: "配置 AI 指令、pull request 默认值以及默认合并方式，以控制 Mintlify Web 编辑器发布变更的方式。"
-keywords: ["编辑器", "设置", "ai", "指令", "发布", "pull request", "合并", "锁定分支"]
+title: "编辑器的 AI 与发布设置"
+sidebarTitle: "设置"
+description: "配置编辑器外观、AI 说明和发布默认值，以控制编辑器的显示方式，以及它提交和合并更改的方式。"
+keywords: ["editor", "settings", "ai", "instructions", "publishing", "pull request", "merge", "appearance", "preferences"]
---
-Web 编辑器有两层设置：
+编辑器的[设置页面](https://app.mintlify.com/settings/deployment/editor)控制外观、发布行为和智能体行为。
-- **个人设置**仅对你生效，控制编辑器的 AI 在你编辑时如何提供协助。
-- **发布设置**对部署中的所有人生效，决定变更在被提交并转换为 pull request 时如何处理。
+- **Appearance**：关于编辑器外观和行为的个人偏好，仅对你生效。
+- **Publishing**：整个 deployment 范围内的默认设置，决定编辑器如何提交更改和打开 pull request，对所有发布者生效。
+- **Chat**：编辑器 AI 智能体的持久说明。
+- **Danger zone**：无法撤销的操作。
-你可以在编辑器的 **Settings** 菜单中配置这两项。
+
+
+## Appearance
-
- ## AI 指令
-AI 指令是编辑器随你的请求一起发送给 AI 的持续生效指令。用它来固定你不想在每次提示中都重复的风格和语气规则，例如语气、术语或格式约定。
+外观偏好与你的用户账户绑定，切换后立即生效。
-你的指令适用于：
+- **Fit editor to full width**：让编辑区域横向铺满，而不使用默认的固定宽度栏。
+- **Show breadcrumbs**：在编辑区域上方显示该页面在站点导航中的位置。
+- **Open live preview in new tab**：预览时在新的浏览器标签页中打开渲染后的页面。若要在[实时预览](/zh/editor/review#live-preview)中编辑站点设置，请保持关闭。
+- **Show all files**：在侧边栏中显示全部文件，包括 dotfile、代码、PDF，以及导航树默认隐藏的其他文件。
-- 对选中文本的 **Edit with AI** 操作，如改写、扩写或修正。
-- 从编辑器中启动的 **agent 会话**。
+
-指令的作用范围是你的用户账号，因此每位团队成员维护各自的指令。
+## PR 说明
-` 表示提示。
-
-保持指令简短而具体。AI 会在每次请求时遵循它们，模糊或相互矛盾的规则会降低效果。
+PR 说明会在 AI 生成 pull request 标题和描述时提供指导。只要编辑器代表你打开 pull request，这些说明就会生效，包括 **Create pull request** 和 **Merge and publish** 流程。
- or components.
-- Do not add introductory filler like "In this guide" or "Let's explore".
+Title: imperative mood, under 70 characters, no trailing period.
+Description: include a "## Summary" section (one sentence) and a
+"## Changes" section as a bulleted list. Link any referenced page
+using its relative path.
```
-将该字段留空以移除你的指令。
+说明的长度上限为 20,000 个字符。
-
- ### 何时使用 AI 指令
-当你发现自己在提示中反复给出相同的指引时，就应该添加 AI 指令，例如：
-
-- 强制使用第二人称或句首大写式的标题。
-- 优先使用特定的产品名称或术语。
-- 禁用营销用语或填充性短语。
-- 要求使用特定组件，例如始终使用 `
- ### 配置 AI 指令
-
+使用 PR 说明来统一审阅者看到的内容，例如：
-1. 打开编辑器，点击工具栏中的头像。
-2. 选择 **Settings**。
-3. 在 **AI instructions** 字段中输入希望 AI 遵循的指令。
-4. 保存更改。
+- 必需的分区，如 **Summary** 和 **Changes**。
+- 链接到跟踪系统的描述模板。
+- 对标题的语气或长度要求。
示例：
```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
- ## 发布设置
-
-
-发布设置按部署进行配置，对所有从编辑器发布的人都生效。它们控制 pull request 和提交的生成、打开和合并方式。
+
-你需要拥有 Mintlify 部署的管理员权限才能更改发布设置。
+## main 分支自动提交
-
- 开启锁定会丢弃部署分支上所有未发布的编辑器更改，并强制将编辑器与你的 Git 仓库重新同步。在开启锁定之前，请先发布待处理的编辑，或将其移动到草稿分支。
+ 启用 main 分支自动提交后，没有待处理状态，也没有审阅机会。你停止输入后不久，每次编辑都会进入已发布的站点。
-在锁定开启期间，向部署分支推送的 Git 提交会覆盖编辑器的实时状态，因此该分支上任何进行中的编辑都会被最新的提交替换。
-
-当你的团队希望 Git 继续作为线上站点的唯一可信来源，并让所有编辑器更改都通过从功能分支发起的 pull request 提交时，可使用此设置。
+
- ### 锁定部署分支
-启用此选项可将你的部署分支（通常是 `main`）在编辑器中设为只读。分支被锁定后：
-
-- 对于查看部署分支的所有人，编辑器和源代码视图都变为只读。
-- `docs.json` 配置面板停止保存更改。
-- 导航编辑（添加页面、重新排序和拖放）会被隐藏。
-- 横幅会提示贡献者先创建草稿分支再进行编辑。
-
-你的部署分支仍与 Git 保持同步，因此从仓库推送仍会更新线上站点。锁定只影响在编辑器中所做的更改。
+main 分支自动提交会在你停止输入后不久，自动把更改推送到 main 分支。如果启用该设置，编辑器会**完全隐藏分支和发布环节**，更改将不经审阅直接上线。
-在部署分支被锁定时进行编辑，请使用顶栏中的分支选择器创建或切换到草稿分支。像其他编辑器分支一样，从你的草稿分支发起 pull request 即可发布这些更改。
+## 默认创建草稿 pull request
-
- ### Pull request 指令
-Pull request 指令用于在 AI 生成 pull request 标题和描述时进行引导。每当编辑器代你打开 pull request 时都会应用，包括 **Create pull request** 和 **Merge and publish** 流程。
-
-使用 pull request 指令来标准化审阅者看到的内容，例如：
+启用该设置后，从编辑器创建的新 pull request 会以草稿形式打开。在你将其标记为可供审阅之前，无法合并草稿 pull request。该设置默认启用。
-- 必需的小节，如 **Summary** 和 **Changes**。
-- 链接到跟踪系统的描述模板。
-- 对标题的语气或长度要求。
+当团队要求在开放审批之前先进行一次人工检查，或者你希望共享预览 URL 但不暗示该更改已可合并时，草稿 pull request 会很有用。
-示例：
+
-```text
-Title: imperative mood, under 70 characters, no trailing period.
-Description: include a "## Summary" section (one sentence) and a
-"## Changes" section as a bulleted list. Link any referenced page
-using its relative path.
-```
+## PR 合并方式
-
+ 让合并方式与 Git 提供方的分支保护设置保持一致。如果 deployment branch 只允许 squash merge，请选择 **Squash**，以免从编辑器合并时失败。
+
-- 你的团队要求在 pull request 开放审批前先进行一次人工审阅。
-- 你希望分享预览 URL，但不希望传递"已准备好合并"的信号。
+
- ### 主分支自动提交
-开启该选项后，编辑器会在你停止编辑后自动将部署分支（通常是 `main`）上的更改提交到 Git。关闭时，部署分支上的更改会在编辑器中保持挂起状态，直到你手动发布。
-
-当你的团队直接在部署分支上编辑，并希望更新在无需手动发布的情况下进入 Git 时，请启用此设置。如果你希望在更改进入部署分支之前先在编辑器中审阅，请保持关闭。
+选择点击 **Merge and publish** 时编辑器合并 pull request 的方式：
-此设置仅影响部署分支。从编辑器创建的功能分支上的编辑无论此设置如何都会继续自动提交，并且锁定部署分支具有更高优先级。
+- **Merge**：创建一个保留完整分支历史的合并 commit。这是默认选项。
+- **Squash**：把分支上的所有 commit 合并为 deployment branch 上的单个 commit。
+- **Rebase**：把分支上的每个 commit 依次重放到 deployment branch 上，不创建合并 commit。
-
- ### 默认以草稿形式创建 pull request
-
+如果你通过 API 或 Git 提供方的界面显式指定了合并方式，则以该选择为准。
-开启该选项后，编辑器会以草稿状态打开每个新的 pull request。在将草稿 pull request 标记为可审阅之前，无法将其合并。该功能在以下场景中很有用：
+
-你仍然可以在 Git 提供商中将 pull request 标记为可审阅。
+## AI 说明
-
- 请让默认合并方式与 Git 提供商的分支保护设置一致。如果你的部署分支只允许 squash 合并，请将默认值设为 **Squash**，以避免从编辑器合并失败。
-
+每位成员都维护自己的说明，与其用户账户绑定。说明的长度上限为 20,000 个字符。
-` 表示提示。
-
- 重置编辑器会丢弃任何尚未提交到 Git 的未发布更改。如果你有想要保留的待处理编辑，请先发布它们。
-
+示例：
-重置编辑器的步骤：
+```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".
+```
-1. 点击编辑器工具栏中的
- 前往 [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/reference/concepts.mdx b/zh/reference/concepts.mdx
index a9aa956772..3854647e24 100644
--- a/zh/reference/concepts.mdx
+++ b/zh/reference/concepts.mdx
@@ -71,7 +71,7 @@ flowchart LR
- **预览部署**会将拉取请求渲染到一个临时 URL，以便审核者在合并前检查结果。
- 将拉取请求合并到部署分支会触发一次生产部署。
-有关完整工作流，请参阅[分支与发布](/zh/editor/branching-and-publishing)。
+有关完整工作流，请参阅[分支与发布](/zh/editor/publish)。
- ### 默认合并方式
-选择在你点击 **Merge and publish** 时编辑器使用的合并方式：
+AI 说明是编辑器随你的请求一并发送给 AI 的持久性指导。用它来固化你不想每次重复的风格和语气规则，例如语态、术语或格式约定。
-- **Merge**：创建一个合并提交，保留分支的完整历史。
-- **Squash**：将分支上的所有提交合并为部署分支上的单个提交。
-- **Rebase**：将分支上的每个提交逐个重放到部署分支，不产生合并提交。
+你的说明适用于：
-所选方式将作为默认值。如果你通过 API 或 Git 提供商的界面显式传入合并方式，那种方式将优先生效。
+- 对选中内容执行的 **Edit with AI** 操作，例如改写、扩写或修正。
+- 从编辑器发起的智能体会话。
-
- ## Danger zone
-
+当你发现自己在提示中反复给出相同的指导时，就可以添加 AI 说明，例如：
-编辑器设置面板中的 **Danger zone** 区域包含无法撤销的操作。点击编辑器工具栏中的
- ### Reset editor
-
-
-**Reset editor** 会强制编辑器丢弃其本地状态并从你的 Git 仓库重新同步。当编辑器与仓库出现同步问题时使用它 —— 例如，文件树为空，或者即使文件确实存在于你的部署分支上、线上站点也在正常构建，编辑器仍显示类似 `Unable to find docs.json or mint.json` 的错误。
+保持说明简短且具体。AI 会在每次请求时遵循这些说明，因此含糊或相互矛盾的规则会降低效果。
-
-
- **Reset editor** 操作位于编辑器的设置面板中，而不是控制台设置的 [Danger zone](https://app.mintlify.com/settings/organization/danger-zone) 中。控制台的 Danger zone 仅用于[删除部署](/zh/deploy/deployments#delete-a-deployment)。
-
+## 重置编辑器
-
-- [发布](/zh/editor/publish)
-- [配置](/zh/editor/configurations)
+**Reset editor** 会强制编辑器丢弃本地状态，并与 Git 仓库重新同步。如果编辑器与仓库持续不同步，例如文件树为空或出现 `Unable to find docs.json` 之类的错误，请重置编辑器。即使该文件确实存在于 deployment branch 上、站点也能正常构建，仍可能出现这种情况。
+
+
+ 重置编辑器会丢弃所有尚未提交到 Git 的未发布更改。如果有想保留的待处理编辑，请先发布它们。
+
diff --git a/zh/editor/suggestions.mdx b/zh/editor/suggestions.mdx
deleted file mode 100644
index b937c5e041..0000000000
--- a/zh/editor/suggestions.mdx
+++ /dev/null
@@ -1,57 +0,0 @@
----
-title: "Mintlify 内容编辑器中的文本建议和协作审阅指南"
-description: "了解如何在 Mintlify 内容编辑器中使用建议模式提出文本更改，查看高亮的待处理建议，并让团队成员审阅、接受或拒绝更改，同时保留当前页面内容不变。查看编辑者、管理员和查看者在建议模式中的权限，以及如何退出建议模式。适用于需要在发布前协作审阅文档内容的团队。"
-keywords: ["建议", "提议", "协作", "审阅"]
----
-
-建议功能可让你在保留当前内容的同时提出文本更改。团队成员可以审阅、接受或拒绝你的建议。
-
-建议模式适用于页面文本。Editors 和 admins 可以接受或拒绝任何建议；viewers 不能。详情参见[角色](/zh/dashboard/roles)。
-
-待处理的建议会在编辑器中以高亮文本显示，并与评论一起列在侧边栏中，方便审阅者查找。
-
-启用建议模式后，编辑器顶部栏会显示 **Suggesting** 指示器。该指示器表示编辑内容会作为建议保存。
-
-
- [Viewers](/zh/dashboard/roles) 始终处于建议模式。当 viewer 打开编辑器时，建议模式会自动启用。顶部栏中的 **Suggesting** 指示器对 viewer 不可交互，因此 viewer 无法退出建议模式。这样一来，viewer 可以在不直接编辑内容的情况下提出更改建议。
-
-
-
-
-
-
-
-
+ 如果遇到困难，请联系你的客户经理（AE，account executive）或解决方案工程师（SE，solutions engineer），或发送邮件至 [support@mintlify.com](mailto:support@mintlify.com)。
+
+
+
+ 在你的站点部署之前，必须由 GitHub 组织所有者或仓库管理员批准 Mintlify GitHub 应用。
+
+
+
+
+ 前往 [mintlify.com/start](https://mintlify.com/start)，使用你的工作邮箱注册。
+
+
+
+ 在初始设置过程中连接 GitHub。在你的公司组织中创建一个仓库或选择一个空仓库。常见的做法是使用一个名为 `docs` 的私有仓库。
+
+ 不要选择包含应用程序代码或无关文件的仓库。
+
+
+
+ 请你的 GitHub 管理员安装 Mintlify GitHub 应用。通过选择 **Only select repositories** 授予对文档仓库的访问权限。
+
+ 有关所请求的权限，请参阅[安装 GitHub 应用](/zh/deploy/github#install-the-github-app)。
+
+
+ 如果你无法批准该应用，请提交安装请求。GitHub 会通知你的组织所有者。
+
+ 要在等待批准期间继续操作，可以在初始设置中跳过 Git 提供商。Mintlify 会创建一个私有仓库，你之后可以在 [Git 设置](https://app.mintlify.com/settings/deployment/git-settings)中迁移它。请参阅[克隆到你自己的仓库](/zh/deploy/github#clone-to-your-own-repository)。
+
+
+
+
+ 入门内容部署完成后，在[控制面板](https://app.mintlify.com/)的 **Overview** 页面找到你的 URL。打开 `https://.mintlify.site` URL 并确认它可以加载。
+
+
+
+除非你需要测试身份验证，否则在 POC 期间请使用 `.mintlify.site` URL。身份验证需要[自定义域名](/zh/customize/custom-domain)或 `*.mintlify.app` 子域名，并且在自定义基础路径（例如 `yourcompany.com/docs`）上不起作用。
+
+
+
+ 询问你的 AE 或 SE 迁移服务是否包含在你的 POC 中。如果包含，请发送：
+
+ - 你当前文档的 URL 或导出文件。
+ - 你的示例页面列表。
+ - 你的 OpenAPI 文件或 URL（如适用）。
+ - 你的品牌资产。
+
+ 完整的迁移流程请参阅[企业迁移](/zh/migration-services/enterprise)。
+
+
+
+ 使用以下方法之一：
+
+ 1. 从当前平台导出 Markdown。按照 [Docusaurus](/zh/migration/docusaurus)、[ReadMe](/zh/migration/readme)、[GitBook](/zh/migration/gitbook)、[Fern](/zh/migration/fern) 或 [Document360](/zh/migration/document360) 的迁移指南操作。
+ 2. 将少量页面粘贴到网页编辑器中并清理格式。
+ 3. 使用 AI 工具结合 Mintlify [skill](/zh/ai/skillmd) 和[管理 MCP 服务器](/zh/ai/mintlify-mcp)转换内容。
+
+ 其他平台请参阅[迁移到 Mintlify](/zh/migration)。
+
+
+
+ 如果你的源内容位于 Notion、Confluence、Jira 或类似工具中，请将其连接到 Mintlify 代理。请参阅[代理和自动化的集成](/zh/automations/integrations)。
+
+
+
+
+
+ 打开[网页编辑器](https://app.mintlify.com/editor)。选择 **Live site** 下拉菜单，打开 **Branches** 标签页，然后选择 **New branch**。
+
+ 分支可以将草稿与已部署的站点分开。
+
+
+
+ 在可视化编辑器中编辑页面。输入 `/` 插入组件，或将图片拖到页面上进行上传。
+
+ 使用眼睛图标预览渲染后的页面，使用 `` 图标查看其 MDX 源码。
+
+
+
+ 复制分支预览 URL 并发送给审阅者。在同一分支上完成所有被要求的修改。
+
+
+
+ 选择 **Publish**。从分支发布会打开或更新一个拉取请求。从 **Live site** 发布会立即部署更改。
+
+ 确认提交出现在控制面板的 **Overview** 页面上，并且已批准的更改出现在你的站点上。
+
+
+
+
+
+ 编辑器的更改会创建 Git 提交，因此 CODEOWNERS、必需审查和分支保护会继续生效。
+
+
+
+ 作者可以继续使用编辑器的 Markdown 视图。工程师可以安装 [CLI](/zh/cli/install)，克隆仓库，并在本地运行 [`mint dev`](/zh/cli/preview)。
+
+
+
+你还可以测试拉取请求的[预览部署](/zh/deploy/preview-deployments)，或[将代理添加到 Slack](/zh/agent/slack#connect-your-slack-workspace)，直接在 Slack 中提出文档更改建议。
+
+
+
+ 将[助手组件](/zh/assistant/widget)添加到你的产品、营销网站或支持门户。
+
+
+
+ 使用[搜索 MCP 服务器](/zh/ai/model-context-protocol)让已发布的内容可在受支持的 AI 工具中使用。使用[管理 MCP 服务器](/zh/ai/mintlify-mcp)起草和编辑文档。
+
+ 你还可以测试[上下文菜单](/zh/ai/contextual-menu)、[`llms.txt`](/zh/ai/llmstxt)、[`skill.md`](/zh/ai/skillmd) 和 [Markdown 页面导出](/zh/ai/markdown-export)。
+
+
+
+ 启用一个[自动化](/zh/automations)，例如起草更新日志或在代码更改后更新文档。先从 **Require review** 开始，然后检查其提出的拉取请求和运行历史。请参阅[管理自动化](/zh/automations/manage)。
+
+
+
+
+ 审查上线前需要配置和验证的所有内容。
+
diff --git a/zh/quickstart.mdx b/zh/quickstart.mdx
index d413a8155f..6b68a10392 100644
--- a/zh/quickstart.mdx
+++ b/zh/quickstart.mdx
@@ -65,7 +65,9 @@ Mintlify 使用“文档即代码”（docs-as-code）的方法来管理你的
- ## 提出建议
-
-
-1. 选中页面上的任意文本。
-2. 在工具栏中点击
-
-
-
-
- ## 接受建议
-
-
-1. 点击高亮的建议文本。
-2. 点击
- ## 拒绝建议
-
-
-1. 点击高亮的建议文本。
-2. 点击
+ ## POC 工作流
+
+
+请按顺序完成以下步骤：
+
+| 步骤 | 成果 |
+|---|---|
+| 1. 连接你的仓库 | 部署一个入门站点。 |
+| 2. 邀请你的团队 | 为参与者提供所需的访问权限。 |
+| 3. 添加示例内容 | 测试具有代表性的复杂页面。 |
+| 4. 发布一次更改 | 验证你的写作和审查工作流。 |
+| 5. 应用品牌样式 | 让站点与你的产品保持一致。 |
+| 6. 测试 AI 功能 | 评估助手的回答和一个 AI 工作流。 |
+| 7. 审查结果 | 将 POC 与你的成功标准进行对比。 |
+
+你的仓库始终是唯一数据源。控制面板让你可以编辑、配置和发布该仓库中的 `.mdx` 文件和 `docs.json` 配置。你的线上站点展示发布后的结果。
+
+
+ ## 开始之前
+
+
+
+ ### 确定参与者
+
+
+| 角色 | 职责 | 所需时间 |
+|---|---|---|
+| 文档负责人 | 主导 POC 并完成大部分步骤。 | 总计几个小时 |
+| GitHub 管理员 | 批准 Mintlify GitHub 应用。 | 15 分钟 |
+| 设计师或品牌负责人 | 提供徽标、颜色和字体。 | 30 分钟 |
+| 身份或 IT 管理员 | 如果你要测试身份验证，为自定义域名配置 DNS。 | 1 到 2 小时 |
+
+
+ ### 收集你的内容和品牌资产
+
+
+请收集：
+
+- SVG 或 PNG 格式的浅色和深色徽标版本。
+- 一个网站图标（favicon），最好是 SVG 格式。
+- 以十六进制值表示的品牌颜色。
+- 字体文件或你的 Google Fonts 字体名称。
+- 你当前文档的链接或内容导出文件。
+- 你的 OpenAPI 文件或 URL（如果你需要为 API 编写文档）。
+- 你流量最高的 20 到 30 个页面。
+
+
+ ### 定义成功标准
+
+
+从客户最常用来衡量 Mintlify 的价值驱动因素中选择一个，并记录其当前基线：
+
+- **获客：** 提高激活率或缩短首次集成所需时间。
+- **工单转移：** 减少某个常见支持主题的工单数量。
+- **节省工程时间：** 减少工程师在编写、审查和维护文档上花费的时间。
+- **留存：** 提高某个功能发布后的采用率。
+
+添加两到三条可以在 POC 期间测试的标准。例如：
+
+- 一位没有 Git 经验的作者可以在无人协助的情况下发布更改。
+- 你最复杂的 API 参考页面能正确渲染。
+- 助手能正确回答 10 个常见支持问题中的 8 个，并引用正确的页面。
+- 你的身份提供商支持控制面板登录。
+
+将目标、基线和标准分享给你的 AE 或 SE。
+
+
+ ## 第 1 步：连接你的仓库
+
+
+
+ ## 第 2 步：邀请你的团队
+
+
+打开[成员](https://app.mintlify.com/settings/organization/members)页面，为每位参与者分配其所需的最小角色：
+
+- **Admin：** 管理组织设置、账单和集成。
+- **Editor：** 创建和发布内容。
+- **Viewer：** 查看控制面板和分析数据，但不能编辑。
+
+完整的权限列表请参阅[角色](/zh/dashboard/roles)。
+
+至少邀请一位不使用 Git 的作者、一位工程师和决策者。使用他们的工作邮箱，以便在第 7 步中将他们的账号连接到你的身份提供商。
+
+
+ ## 第 3 步：添加示例内容
+
+
+
+ ### 选择有代表性的页面
+
+
+从你流量最高的 20 到 30 个页面开始。请包含：
+
+- 你最复杂的 API 参考页面。
+- 一个包含大型表格或深层嵌套列表的页面。
+- 一个包含图片、视频或图表的页面。
+- 一个包含自定义组件或嵌入式小组件的页面。
+- 两到三篇典型的指南。
+
+将示例控制在 50 页以内，以便你专注于迁移质量。
+
+
+ ### 迁移内容
+
+
+
+ ### 审查迁移结果
+
+
+将每个示例页面与其源页面进行对比。检查：
+
+- 图片、表格和代码示例。
+- 内部和外部链接。
+- 自定义组件和嵌入内容。
+- 导航标签和页面位置。
+
+确认新用户能在两次点击内到达有用的页面，并且导航标签使用读者可能搜索的术语。将迁移问题整理成一份列表（包含页面 URL 和预期结果）发送给你的 AE 或 SE。
+
+
+ ## 第 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`，请将资产发送给你的 AE 或 SE。
+
+
+ ## 第 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 步：审查结果
+
+
+与决策者预约一小时的会议。从 POC 前定义的目标和基线开始，然后审查：
+
+| 标准 | 证据 |
+|---|---|
+| 非开发人员可以发布内容 | 第 4 步的结果和所需时间。 |
+| 工程师保留审查控制权 | 拉取请求及其检查。 |
+| 复杂内容迁移正确 | 示例页面的并排对比。 |
+| 助手回答准确 | 你评分过的问题和引用的页面。 |
+| 可以识别内容缺口 | [助手分析](/zh/analytics/assistant)中未回答和被点踩的问题。 |
+| 读者能找到有用的内容 | [流量](/zh/analytics/traffic)、[搜索](/zh/analytics/search)和[用户参与](/zh/analytics/user-engagements)数据。 |
+| 自动更新有价值 | 自动化的运行历史和提出的更改。 |
+
+在此会议之前，与你的 AE 或 SE 解决所有未决问题。
+
+
+ ## 建议时间表
+
+
+大多数 POC 需要两到三周：
+
+| 周 | 重点 |
+|---|---|
+| 第 1 周 | 连接仓库、邀请团队、定义成功标准并开始内容迁移。如果需要身份验证，开始域名设置。 |
+| 第 2 周 | 审查内容、发布一次更改、应用品牌样式、测试助手并评估一个 AI 工作流。 |
+| 第 3 周 | 与决策者一起审查结果。 |
+
+
+ ## 获取帮助
+
+
+- 如有紧急的 POC 问题，请联系你的 AE 或 SE。
+- 其他问题请发送邮件至 [support@mintlify.com](mailto:support@mintlify.com)。
+- POC 之后的支持选项请参阅[高级支持](/zh/advanced-support)。
+
+
+ ## POC 之后
+
+
+
## 构建会将源文件转换为读者体验
diff --git a/zh/reference/glossary.mdx b/zh/reference/glossary.mdx
index dd0ebee102..2c26844bb9 100644
--- a/zh/reference/glossary.mdx
+++ b/zh/reference/glossary.mdx
@@ -196,7 +196,7 @@ Mintlify 与其他服务之间的连接。集成可提供分析、聊天、隐
### Live preview（实时预览）
-在网页编辑器中对你未发布的编辑进行的持续更新渲染。实时预览不会公开部署。参阅 [Live preview](/zh/editor/live-preview)。
+在网页编辑器中对你未发布的编辑进行的持续更新渲染。实时预览不会公开部署。参阅 [Live preview](/zh/editor/review#live-preview)。
### Live site（线上站点）
diff --git a/zh/search-index/mcp.mdx b/zh/search-index/mcp.mdx
index 5c8905d146..6c4a14f15a 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`。请等待后重试，自动化客户端应使用指数退避。