From bf6187efb3ea86568163ee56964f527578c7ab51 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 24 Jul 2026 08:40:49 +0000 Subject: [PATCH 1/4] docs: add July 24 2026 product update to changelog --- changelog.mdx | 75 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 75 insertions(+) diff --git a/changelog.mdx b/changelog.mdx index dde7bdc04e..acc5d67089 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -5,6 +5,81 @@ rss: true noindex: true --- + + + ## API and SDK references + + - **GraphQL API reference pages:** Generate reference pages from a GraphQL SDL schema, with linked types and example queries, mutations, and responses. See [GraphQL setup](/api-playground/graphql-setup). + - **SDK reference generation:** Build SDK reference pages directly from the output of TypeDoc, DocFX, Javadoc, Sphinx, or phpDocumentor. See [SDK reference setup](/api-playground/sdk-reference-setup). + + ## Editor + + - **Review flow:** Request review on a draft, leave feedback, and approve or request changes before publishing. Reviews now support non-deploy branches. + - **Editor agent reads your code repos:** Give the [editor agent](/editor/agent) read-only access to connected code repositories so it can ground documentation edits in your source. + - **Top-level page comments:** Start a comment thread on a page itself, not just on selected text. + - **Mention yourself in comments:** `@`-mention your own account in [editor comments](/editor/comments) to leave reminders. + - **New keyboard shortcuts:** `Option+S` opens a [suggestion](/editor/suggestions) on the selected text and `Option+C` opens a [comment](/editor/comments). + - **Cursor focuses at top on open:** Opening a page now places the cursor at the top of the document. + - **Faster load:** The editor no longer waits on the git file tree to render. + - **View without GitHub permissions:** Users without repo write access can now open the editor in read-only mode instead of getting blocked. + + ## Assistant and widget + + - **Simplified [Assistant Widget](/guides/assistant-embed):** Cleaner configuration, framework-neutral loader, configurable initial theme, improved Markdown rendering, and a refreshed composer, trigger, and playground UI. + - **Pre-filled contact form:** When the assistant hands off to support, it now pre-fills the contact form message from the conversation so users don't have to re-explain their issue. + - **ChatGPT MCP connector:** Add Mintlify docs as a [ChatGPT connector](/ai/mintlify-mcp) so ChatGPT can search and cite your documentation. + - **Claude in automations:** Automations now support Claude as a model provider. + + ## Automations and Slack agent + + - **Automation analytics dashboard:** A new analytics view for [automations](/automations) with per-workflow run history, outcomes, and trends. + - **Composio integrations:** Third-party integrations for automations are now powered by Composio, with a shared connect flow across the dashboard and Slack agent. + - **Integration triggers:** Trigger automations from third-party events (for example, a Slack message or a support ticket update) via [Composio triggers](/automations/integrations). + - **User-scoped integrations:** Connect third-party tools under your own account and pick them from the automations picker, alongside org-wide connections. + - **One-shot scheduled workflows:** Schedule an automation to run once at a future time and auto-delete after it finishes. + - **Filtered changelog URLs:** Share a [changelog](/changelog) link filtered to a specific tag. + - **Slack agent reads PR activity:** The [Slack agent](/agent/slack) now reads PR comments, reviews, and CI checks, and follows up in the thread after reverting a change based on feedback. + + ## CLI + + - **`mint format`:** Format MDX files with Mintlify's bundled editor converter for consistent structure across your docs. See [CLI commands](/cli/commands). + - **`mint deslop`:** Detect AI-sounding prose and get humanization suggestions before publishing. + - **`mint add-domain`:** Configure a [custom domain](/customize/custom-domain) from the CLI without leaving your terminal. + - **Nicer `--help` output:** Consistent `--help` formatting across every command and a friendlier prompt when the CLI is invoked by an AI agent. + + ## Analytics + + - **Feedback revamp:** The [analytics feedback](/optimize/feedback) section now surfaces per-page ratings and opens a detailed feedback drawer with the underlying comments. + - **Human vs. agent page rankings:** Page rankings now split human and agent traffic into separate columns so you can see who's really reading each page. + - **Analytics streaming config:** Pick which deployments to include when [streaming analytics](/optimize/analytics) to your own warehouse. + + ## Deployments and search + + - **Search on preview deployments:** Preview deployments now serve docs search, so you can validate search results before merging. + - **Deep-link PR previews:** GitHub PR preview links now open directly on the page you changed. + - **GHES repo selection:** Self-hosted GitHub Enterprise Server repositories can now be selected in [git settings](/deploy/ghes). + - **Ignore `.mintlify` by default:** The `.mintlify` directory is ignored on deploy by default, except for `skills` and `specs`. + + ## Bug fixes + + - Search domain path casing is preserved end-to-end. + - Fuzzy search now only falls back to near-typo matches instead of loose fuzzy hits. + - Stuck search indexing jobs are recovered by a new watchdog, and search AST uploads retry on transient S3 failures instead of silently dropping pages. + - Search emits per-context version and product tags for pages that are cross-listed across contexts. + - Preview builds now surface branch deletion clearly instead of showing a misleading build error. + - The editor now round-trips task list checkboxes, table escapes, LaTeX math, callout `type` attributes, video sources, image titles, and inline code with pipes inside table cells. + - The editor allows block content inside `Columns` so nested blocks don't get silently deleted. + - PDF exports are now rendered in light mode regardless of the reader's theme. + - `.md` page internal links and the `Link` header respect your `basePath`. + - Authenticated docs correctly refresh expired end-user JWTs in the search proxy and serve a genuine 404 for missing pages on allowlisted deployments. + - The Assistant Widget waits for hCaptcha to be ready before submitting and preserves historical response actions across reloads. + - Subpath domain setup preserves its pending state during DNS provisioning and hides the DNS migration step where it doesn't apply. + - The `luma` and `sequoia` themes correctly center content in center page mode, and the `maple` theme keeps the API side panel below the tabs navigation. + - Duplicate page names in the dashboard now append a slug instead of colliding, and the products redirect preserves the authentication segment. + - Password auth renders read-only when unentitled instead of crashing the settings page. + + + ## Page improvements From c0e9a04543084b0200861d9520e81bbdfd8bd899 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 24 Jul 2026 08:45:48 +0000 Subject: [PATCH 2/4] docs: translate July 24 changelog entry into es, fr, zh --- es/changelog.mdx | 91 ++++++++++++++++++++++++++++++++++++++++++++++++ fr/changelog.mdx | 91 ++++++++++++++++++++++++++++++++++++++++++++++++ zh/changelog.mdx | 91 ++++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 273 insertions(+) diff --git a/es/changelog.mdx b/es/changelog.mdx index f93fbaeb73..0afe19032a 100644 --- a/es/changelog.mdx +++ b/es/changelog.mdx @@ -5,6 +5,97 @@ rss: true noindex: true --- + + +
+ ## Referencias de API y SDK +
+ + - **Páginas de referencia de API de GraphQL:** Genera páginas de referencia a partir de un esquema SDL de GraphQL, con tipos enlazados y ejemplos de queries, mutations y respuestas. Consulta [Configuración de GraphQL](/es/api-playground/graphql-setup). + - **Generación de referencias de SDK:** Crea páginas de referencia de SDK directamente desde la salida de TypeDoc, DocFX, Javadoc, Sphinx o phpDocumentor. Consulta [Configuración de la referencia de SDK](/es/api-playground/sdk-reference-setup). + +
+ ## Editor +
+ + - **Flujo de revisión:** Solicita la revisión de un borrador, deja comentarios y aprueba o solicita cambios antes de publicar. Las revisiones ahora admiten ramas que no son de despliegue. + - **El agente del editor lee tus repos de código:** Otorga al [agente del editor](/es/editor/agent) acceso de solo lectura a los repositorios de código conectados para que pueda fundamentar las ediciones de la documentación en tu código fuente. + - **Comentarios de página de nivel superior:** Inicia un hilo de comentarios sobre la propia página, no solo sobre el texto seleccionado. + - **Menciónate en los comentarios:** Usa `@`-mención a tu propia cuenta en los [comentarios del editor](/es/editor/comments) para dejarte recordatorios. + - **Nuevos atajos de teclado:** `Option+S` abre una [sugerencia](/es/editor/suggestions) sobre el texto seleccionado y `Option+C` abre un [comentario](/es/editor/comments). + - **El cursor se enfoca al inicio al abrir:** Abrir una página ahora coloca el cursor al inicio del documento. + - **Carga más rápida:** El editor ya no espera al árbol de archivos de git para renderizarse. + - **Vista sin permisos de GitHub:** Los usuarios sin acceso de escritura al repositorio ahora pueden abrir el editor en modo de solo lectura en lugar de quedar bloqueados. + +
+ ## Asistente y widget +
+ + - **[Assistant Widget](/es/guides/assistant-embed) simplificado:** Configuración más limpia, cargador neutral respecto al framework, tema inicial configurable, renderizado mejorado de Markdown y una UI renovada del compositor, disparador y playground. + - **Formulario de contacto prellenado:** Cuando el asistente deriva al soporte, ahora prellena el mensaje del formulario de contacto a partir de la conversación para que los usuarios no tengan que volver a explicar su problema. + - **Conector MCP de ChatGPT:** Añade la documentación de Mintlify como [conector de ChatGPT](/es/ai/mintlify-mcp) para que ChatGPT pueda buscar y citar tu documentación. + - **Claude en automations:** Las automations ahora admiten Claude como proveedor de modelos. + +
+ ## Automations y agente de Slack +
+ + - **Dashboard de analytics de automations:** Una nueva vista de analytics para [automations](/es/automations) con historial de ejecuciones, resultados y tendencias por flujo. + - **Integraciones de Composio:** Las integraciones de terceros para automations ahora funcionan con Composio, con un flujo de conexión compartido entre el dashboard y el agente de Slack. + - **Disparadores de integraciones:** Activa automations a partir de eventos de terceros (por ejemplo, un mensaje de Slack o la actualización de un ticket de soporte) mediante [disparadores de Composio](/es/automations/integrations). + - **Integraciones con alcance de usuario:** Conecta herramientas de terceros bajo tu propia cuenta y selecciónalas desde el selector de automations, junto con las conexiones a nivel de organización. + - **Flujos programados de una sola ejecución:** Programa una automation para que se ejecute una vez en el futuro y se elimine automáticamente al finalizar. + - **URLs filtradas del changelog:** Comparte un enlace del [changelog](/es/changelog) filtrado por una etiqueta específica. + - **El agente de Slack lee la actividad de PRs:** El [agente de Slack](/es/agent/slack) ahora lee los comentarios de PR, las revisiones y los checks de CI, y da seguimiento en el hilo después de revertir un cambio a partir del feedback. + +
+ ## CLI +
+ + - **`mint format`:** Formatea archivos MDX con el conversor de editor integrado de Mintlify para lograr una estructura consistente en toda tu documentación. Consulta [Comandos de la CLI](/es/cli/commands). + - **`mint deslop`:** Detecta prosa con tono de IA y obtén sugerencias de humanización antes de publicar. + - **`mint add-domain`:** Configura un [dominio personalizado](/es/customize/custom-domain) desde la CLI sin salir de tu terminal. + - **Salida de `--help` más agradable:** Formato consistente de `--help` en todos los comandos y un mensaje más amable cuando la CLI es invocada por un agente de IA. + +
+ ## Analytics +
+ + - **Feedback renovado:** La sección de [feedback de analytics](/es/optimize/feedback) ahora muestra las valoraciones por página y abre un panel detallado de feedback con los comentarios subyacentes. + - **Rankings de páginas humano vs. agente:** Los rankings de páginas ahora separan el tráfico humano y el de agentes en columnas distintas para que puedas ver quién está leyendo realmente cada página. + - **Configuración de streaming de analytics:** Elige qué despliegues incluir cuando hagas [streaming de analytics](/es/optimize/analytics) a tu propio warehouse. + + + + - **Búsqueda en despliegues de vista previa:** Los despliegues de vista previa ahora sirven la búsqueda de documentación, por lo que puedes validar los resultados de búsqueda antes de hacer merge. + - **Enlaces directos en vistas previas de PR:** Los enlaces de vista previa de PR de GitHub ahora se abren directamente en la página que modificaste. + - **Selección de repos de GHES:** Los repositorios autoalojados de GitHub Enterprise Server ahora pueden seleccionarse en la [configuración de git](/es/deploy/ghes). + - **Ignorar `.mintlify` por defecto:** El directorio `.mintlify` se ignora al desplegar por defecto, excepto `skills` y `specs`. + +
+ ## Correcciones +
+ + - Las mayúsculas y minúsculas de la ruta del dominio de búsqueda se conservan de extremo a extremo. + - La búsqueda difusa ahora solo recurre a coincidencias casi tipográficas en lugar de aciertos difusos poco precisos. + - Los trabajos de indexación de búsqueda atascados se recuperan con un nuevo watchdog, y las subidas de AST de búsqueda reintentan ante fallos transitorios de S3 en lugar de descartar páginas de forma silenciosa. + - La búsqueda emite etiquetas de versión y producto por contexto para páginas que están listadas de forma cruzada entre contextos. + - Las compilaciones de vista previa ahora muestran claramente la eliminación de ramas en lugar de un error de compilación engañoso. + - El editor ahora conserva en ida y vuelta las casillas de listas de tareas, los escapes en tablas, matemáticas en LaTeX, atributos `type` de callouts, fuentes de vídeo, títulos de imágenes y código en línea con barras verticales dentro de celdas de tablas. + - El editor permite contenido de bloque dentro de `Columns` para que los bloques anidados no se eliminen de forma silenciosa. + - Las exportaciones en PDF ahora se renderizan en modo claro independientemente del tema del lector. + - Los enlaces internos de páginas `.md` y la cabecera `Link` respetan tu `basePath`. + - La documentación autenticada refresca correctamente los JWT expirados de los usuarios finales en el proxy de búsqueda y sirve un 404 real para páginas inexistentes en despliegues incluidos en la lista de permitidos. + - El Assistant Widget espera a que hCaptcha esté listo antes de enviar y conserva las acciones históricas de respuesta entre recargas. + - La configuración de dominio en subruta conserva su estado pendiente durante el aprovisionamiento de DNS y oculta el paso de migración de DNS donde no aplica. + - Los temas `luma` y `sequoia` centran correctamente el contenido en modo de página centrada, y el tema `maple` mantiene el panel lateral de API por debajo de la navegación por pestañas. + - Los nombres de página duplicados en el dashboard ahora añaden un slug en lugar de chocar, y la redirección de productos conserva el segmento de autenticación. + - La autenticación por contraseña se renderiza como solo lectura cuando no está habilitada en lugar de bloquear la página de configuración. + + +
diff --git a/fr/changelog.mdx b/fr/changelog.mdx index 1ad87479dd..1bb9d346ea 100644 --- a/fr/changelog.mdx +++ b/fr/changelog.mdx @@ -5,6 +5,97 @@ rss: true noindex: true --- + + +
+ ## Références API et SDK +
+ + - **Pages de référence de l'API GraphQL :** Générez des pages de référence à partir d'un schéma SDL GraphQL, avec des types liés et des exemples de requêtes, mutations et réponses. Consultez [Configuration GraphQL](/fr/api-playground/graphql-setup). + - **Génération de références SDK :** Créez des pages de référence SDK directement à partir de la sortie de TypeDoc, DocFX, Javadoc, Sphinx ou phpDocumentor. Consultez [Configuration de la référence SDK](/fr/api-playground/sdk-reference-setup). + +
+ ## Éditeur +
+ + - **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. + - **L'agent de l'éditeur lit vos dépôts de code :** Donnez à l'[agent de l'éditeur](/fr/editor/agent) un accès en lecture seule aux dépôts de code connectés afin qu'il puisse appuyer les modifications de la documentation sur votre code source. + - **Commentaires de niveau page :** Démarrez un fil de commentaires sur une page elle-même, et pas seulement sur du texte sélectionné. + - **Se mentionner dans les commentaires :** Utilisez `@` pour mentionner votre propre compte dans les [commentaires de l'éditeur](/fr/editor/comments) afin de laisser des rappels. + - **Nouveaux raccourcis clavier :** `Option+S` ouvre une [suggestion](/fr/editor/suggestions) sur le texte sélectionné et `Option+C` ouvre un [commentaire](/fr/editor/comments). + - **Le curseur se place en haut à l'ouverture :** Ouvrir une page place désormais le curseur en haut du document. + - **Chargement plus rapide :** L'éditeur n'attend plus l'arborescence des fichiers git pour s'afficher. + - **Consultation sans permissions GitHub :** Les utilisateurs sans accès en écriture au dépôt peuvent désormais ouvrir l'éditeur en lecture seule au lieu d'être bloqués. + +
+ ## Assistant et widget +
+ + - **[Assistant Widget](/fr/guides/assistant-embed) simplifié :** Configuration allégée, loader indépendant du framework, thème initial configurable, meilleur rendu Markdown, et interfaces rafraîchies pour le composer, le déclencheur et le playground. + - **Formulaire de contact pré-rempli :** Lorsque l'assistant transfère la conversation au support, il pré-remplit désormais le message du formulaire de contact à partir de la conversation, afin que les utilisateurs n'aient pas à ré-expliquer leur problème. + - **Connecteur MCP ChatGPT :** Ajoutez la documentation Mintlify comme [connecteur ChatGPT](/fr/ai/mintlify-mcp) pour que ChatGPT puisse rechercher et citer votre documentation. + - **Claude dans les automations :** Les automations prennent désormais en charge Claude comme fournisseur de modèle. + +
+ ## Automations et agent Slack +
+ + - **Dashboard d'analytics des automations :** Une nouvelle vue analytics pour les [automations](/fr/automations) avec l'historique d'exécution par workflow, les résultats et les tendances. + - **Intégrations Composio :** Les intégrations tierces pour les automations sont désormais propulsées par Composio, avec un flux de connexion partagé entre le dashboard et l'agent Slack. + - **Déclencheurs d'intégration :** Déclenchez des automations depuis des événements tiers (par exemple, un message Slack ou une mise à jour de ticket de support) via les [déclencheurs Composio](/fr/automations/integrations). + - **Intégrations à portée utilisateur :** Connectez des outils tiers sous votre propre compte et sélectionnez-les depuis le sélecteur d'automations, aux côtés des connexions à l'échelle de l'organisation. + - **Workflows planifiés à exécution unique :** Planifiez l'exécution d'une automation une seule fois à une date future, avec suppression automatique après son achèvement. + - **URL de changelog filtrées :** Partagez un lien de [changelog](/fr/changelog) filtré sur un tag spécifique. + - **L'agent Slack lit l'activité des PR :** L'[agent Slack](/fr/agent/slack) lit désormais les commentaires de PR, les revues et les vérifications CI, et effectue un suivi dans le fil après avoir annulé une modification à la suite d'un retour. + +
+ ## CLI +
+ + - **`mint format` :** Formatez les fichiers MDX avec le convertisseur d'éditeur intégré de Mintlify pour une structure cohérente à travers votre documentation. Consultez [Commandes CLI](/fr/cli/commands). + - **`mint deslop` :** Détectez la prose au ton IA et obtenez des suggestions d'humanisation avant publication. + - **`mint add-domain` :** Configurez un [domaine personnalisé](/fr/customize/custom-domain) depuis la CLI sans quitter votre terminal. + - **Sortie `--help` améliorée :** Formatage `--help` cohérent pour chaque commande et invite plus conviviale lorsque la CLI est appelée par un agent IA. + +
+ ## Analytics +
+ + - **Refonte du feedback :** La section [feedback dans l'analytics](/fr/optimize/feedback) fait désormais apparaître les notes par page et ouvre un tiroir de feedback détaillé avec les commentaires sous-jacents. + - **Classement des pages : humains vs. agents :** Le classement des pages sépare désormais le trafic humain et le trafic des agents en colonnes distinctes afin que vous puissiez voir qui lit réellement chaque page. + - **Configuration du streaming d'analytics :** Choisissez les déploiements à inclure lors du [streaming des analytics](/fr/optimize/analytics) vers votre propre entrepôt de données. + + + + - **Recherche sur les déploiements d'aperçu :** Les déploiements d'aperçu servent désormais la recherche de documentation, afin que vous puissiez valider les résultats de recherche avant fusion. + - **Liens profonds vers les aperçus de PR :** Les liens d'aperçu de PR GitHub s'ouvrent désormais directement sur la page que vous avez modifiée. + - **Sélection de dépôts GHES :** Les dépôts GitHub Enterprise Server auto-hébergés peuvent désormais être sélectionnés dans les [paramètres git](/fr/deploy/ghes). + - **`.mintlify` ignoré par défaut :** Le dossier `.mintlify` est ignoré au déploiement par défaut, à l'exception de `skills` et `specs`. + +
+ ## Corrections de bugs +
+ + - La casse du chemin du domaine de recherche est préservée de bout en bout. + - La recherche floue ne se rabat désormais que sur des correspondances proches d'une faute de frappe au lieu de correspondances floues laxistes. + - Les tâches d'indexation de recherche bloquées sont récupérées par un nouveau watchdog, et les envois d'AST de recherche sont réessayés en cas d'échec transitoire de S3 au lieu d'abandonner silencieusement des pages. + - La recherche émet des tags de version et de produit par contexte pour les pages référencées dans plusieurs contextes. + - Les builds d'aperçu font désormais apparaître clairement la suppression d'une branche au lieu d'afficher une erreur de build trompeuse. + - L'éditeur préserve désormais à l'aller-retour les cases à cocher des listes de tâches, les échappements de tableau, les mathématiques LaTeX, les attributs `type` des callouts, les sources vidéo, les titres d'image et le code inline contenant des barres verticales à l'intérieur des cellules de tableau. + - L'éditeur autorise le contenu de type bloc à l'intérieur des `Columns` afin que les blocs imbriqués ne soient pas supprimés silencieusement. + - Les exports PDF sont désormais rendus en mode clair quel que soit le thème du lecteur. + - Les liens internes des pages `.md` et l'en-tête `Link` respectent votre `basePath`. + - La documentation authentifiée rafraîchit correctement les JWT d'utilisateur final expirés dans le proxy de recherche et sert un véritable 404 pour les pages manquantes sur les déploiements en liste d'autorisation. + - L'Assistant Widget attend que hCaptcha soit prêt avant de soumettre et préserve les actions historiques de réponse entre les rechargements. + - La configuration de domaine sur sous-chemin conserve son état en attente pendant le provisionnement DNS et masque l'étape de migration DNS lorsqu'elle ne s'applique pas. + - Les thèmes `luma` et `sequoia` centrent correctement le contenu en mode page centrée, et le thème `maple` maintient le panneau latéral de l'API sous la navigation par onglets. + - Les noms de page dupliqués dans le dashboard ajoutent désormais un slug au lieu d'entrer en collision, et la redirection des produits préserve le segment d'authentification. + - L'authentification par mot de passe s'affiche en lecture seule lorsqu'elle n'est pas autorisée au lieu de faire planter la page des paramètres. + + +
diff --git a/zh/changelog.mdx b/zh/changelog.mdx index c1c774785d..b289ed5a43 100644 --- a/zh/changelog.mdx +++ b/zh/changelog.mdx @@ -5,6 +5,97 @@ rss: true noindex: true --- + + +
+ ## API 与 SDK 参考 +
+ + - **GraphQL API 参考页面：** 根据 GraphQL SDL schema 生成参考页面，包含类型链接以及示例查询、mutation 和响应。请参阅 [GraphQL 设置](/zh/api-playground/graphql-setup)。 + - **SDK 参考生成：** 直接根据 TypeDoc、DocFX、Javadoc、Sphinx 或 phpDocumentor 的输出构建 SDK 参考页面。请参阅 [SDK 参考设置](/zh/api-playground/sdk-reference-setup)。 + +
+ ## 编辑器 +
+ + - **评审流程：** 在草稿上发起评审、留下反馈，并在发布前批准或请求修改。评审现已支持非部署分支。 + - **编辑器代理读取您的代码仓库：** 授予[编辑器代理](/zh/editor/agent)对已连接代码仓库的只读访问权限，使其能够基于您的源代码进行文档编辑。 + - **页面顶级评论：** 直接在页面本身而不仅仅是所选文本上发起评论线程。 + - **在评论中提及自己：** 在[编辑器评论](/zh/editor/comments)中使用 `@` 提及自己的账号，以留下备忘提醒。 + - **新的键盘快捷键：** `Option+S` 可对所选文本打开[建议](/zh/editor/suggestions)，`Option+C` 可打开[评论](/zh/editor/comments)。 + - **打开页面时光标聚焦顶部：** 打开页面时,光标现在会定位到文档顶部。 + - **加载更快：** 编辑器不再等待 git 文件树完成渲染。 + - **无 GitHub 权限也可查看：** 没有仓库写入权限的用户现在可以以只读模式打开编辑器,而不再被拦截。 + +
+ ## 助手与小部件 +
+ + - **简化的 [Assistant Widget](/zh/guides/assistant-embed)：** 更简洁的配置、框架中立的加载器、可配置的初始主题、改进的 Markdown 渲染，以及焕新的编辑器、触发器和 playground 界面。 + - **预填联系表单：** 当助手转接到支持时,现在会根据对话内容预填联系表单中的消息,用户无需再重复说明问题。 + - **ChatGPT MCP 连接器：** 将 Mintlify 文档添加为 [ChatGPT 连接器](/zh/ai/mintlify-mcp)，让 ChatGPT 能够搜索并引用您的文档。 + - **自动化中的 Claude：** 自动化现已支持 Claude 作为模型提供方。 + +
+ ## 自动化与 Slack 代理 +
+ + - **自动化分析 dashboard：** 面向[自动化](/zh/automations)的全新分析视图，包含每个工作流的运行历史、结果和趋势。 + - **Composio 集成：** 自动化的第三方集成现在由 Composio 提供支持，dashboard 和 Slack 代理共用同一套连接流程。 + - **集成触发器：** 通过 [Composio 触发器](/zh/automations/integrations)，从第三方事件（例如 Slack 消息或工单更新）触发自动化。 + - **用户范围的集成：** 在自己的账号下连接第三方工具，并可在自动化选择器中与组织级连接一同选用。 + - **一次性定时工作流：** 将自动化安排在未来某个时间运行一次，运行结束后自动删除。 + - **筛选后的 changelog URL：** 分享按特定标签筛选后的 [changelog](/zh/changelog) 链接。 + - **Slack 代理读取 PR 活动：** [Slack 代理](/zh/agent/slack)现在会读取 PR 评论、评审和 CI 检查，并在根据反馈回滚变更后在会话中跟进说明。 + +
+ ## CLI +
+ + - **`mint format`：** 使用 Mintlify 内置的编辑器转换器格式化 MDX 文件，让文档结构保持一致。请参阅 [CLI 命令](/zh/cli/commands)。 + - **`mint deslop`：** 检测听起来像 AI 生成的行文，并在发布前给出人性化改写建议。 + - **`mint add-domain`：** 直接从 CLI 配置[自定义域名](/zh/customize/custom-domain)，无需离开终端。 + - **更友好的 `--help` 输出：** 所有命令的 `--help` 格式统一，并在 CLI 被 AI 代理调用时提供更友好的提示。 + +
+ ## Analytics +
+ + - **反馈改版：** [analytics 反馈](/zh/optimize/feedback)部分现在会展示每页评分，并可打开详细反馈抽屉查看底层评论。 + - **人类与代理页面排名：** 页面排名现在将人类和代理流量拆分为独立的列，方便您查看每个页面的真实读者构成。 + - **Analytics 流式配置：** 在[流式传输 analytics](/zh/optimize/analytics) 到自有数据仓库时，可选择要包含的部署。 + + + + - **预览部署上的搜索：** 预览部署现在也提供文档搜索，方便您在合并前验证搜索结果。 + - **深链 PR 预览：** GitHub PR 预览链接现在会直接打开您所修改的页面。 + - **GHES 仓库选择：** 自托管的 GitHub Enterprise Server 仓库现在可以在 [git 设置](/zh/deploy/ghes)中选择。 + - **默认忽略 `.mintlify`：** 部署时默认忽略 `.mintlify` 目录，但 `skills` 和 `specs` 除外。 + +
+ ## 错误修复 +
+ + - 搜索域名路径的大小写在整个链路中得以保留。 + - 模糊搜索现在只会回退到接近拼写错误的匹配，而不再是宽泛的模糊命中。 + - 卡住的搜索索引任务由新的看门狗机制恢复，搜索 AST 上传在 S3 出现瞬时故障时会重试，而不会静默丢弃页面。 + - 对于跨上下文交叉列出的页面，搜索会发出针对每个上下文的版本和产品标签。 + - 预览构建现在会清晰显示分支已删除的情况，而不是显示误导性的构建错误。 + - 编辑器现在可以正确往返处理任务列表复选框、表格转义、LaTeX 数学公式、callout 的 `type` 属性、视频源、图片标题，以及表格单元格内包含竖线的内联代码。 + - 编辑器允许在 `Columns` 中放置块级内容，嵌套的块不会被静默删除。 + - PDF 导出现在始终以浅色模式渲染，无论读者的主题设置为何。 + - `.md` 页面的内部链接和 `Link` 请求头会遵循您的 `basePath`。 + - 受身份验证保护的文档现在会在搜索代理中正确刷新过期的终端用户 JWT，并在允许列表内的部署中为缺失页面返回真正的 404。 + - Assistant Widget 会在提交前等待 hCaptcha 准备就绪，并在重新加载后保留历史响应操作。 + - 子路径域名设置在 DNS 配置期间会保留其待处理状态，并在不适用时隐藏 DNS 迁移步骤。 + - `luma` 和 `sequoia` 主题在居中页面模式下能正确居中内容，`maple` 主题则会让 API 侧边面板保持在标签导航之下。 + - dashboard 中重名的页面现在会追加 slug 而不再冲突，产品重定向也会保留身份验证片段。 + - 密码认证在没有相应授权时会以只读方式渲染，而不会导致设置页面崩溃。 + + +
From 7e5802a773344991f7a22d003e04a83d6b9ca222 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Fri, 24 Jul 2026 13:17:23 -0700 Subject: [PATCH 3/4] =?UTF-8?q?=F0=9F=92=85?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- changelog.mdx | 79 ++++++++++++++++----------------------------------- 1 file changed, 24 insertions(+), 55 deletions(-) diff --git a/changelog.mdx b/changelog.mdx index acc5d67089..ec0fb1917a 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -5,78 +5,47 @@ rss: true noindex: true --- - + - ## API and SDK references + ## GraphQL and SDK references - **GraphQL API reference pages:** Generate reference pages from a GraphQL SDL schema, with linked types and example queries, mutations, and responses. See [GraphQL setup](/api-playground/graphql-setup). - **SDK reference generation:** Build SDK reference pages directly from the output of TypeDoc, DocFX, Javadoc, Sphinx, or phpDocumentor. See [SDK reference setup](/api-playground/sdk-reference-setup). - ## Editor + ## Editor and collaboration - **Review flow:** Request review on a draft, leave feedback, and approve or request changes before publishing. Reviews now support non-deploy branches. - - **Editor agent reads your code repos:** Give the [editor agent](/editor/agent) read-only access to connected code repositories so it can ground documentation edits in your source. - - **Top-level page comments:** Start a comment thread on a page itself, not just on selected text. - - **Mention yourself in comments:** `@`-mention your own account in [editor comments](/editor/comments) to leave reminders. - - **New keyboard shortcuts:** `Option+S` opens a [suggestion](/editor/suggestions) on the selected text and `Option+C` opens a [comment](/editor/comments). - - **Cursor focuses at top on open:** Opening a page now places the cursor at the top of the document. - - **Faster load:** The editor no longer waits on the git file tree to render. - - **View without GitHub permissions:** Users without repo write access can now open the editor in read-only mode instead of getting blocked. - - ## Assistant and widget + - **More ways to collaborate:** Start [comment threads](/editor/comments) on an entire page, mention yourself to leave a reminder, and use keybaord shortcuts Option + C or Option + S to comment on or suggest changes to selected text. + - **Faster, more available editing:** The editor renders without waiting for the Git file tree and people without GitHub write access can use the editor. - - **Simplified [Assistant Widget](/guides/assistant-embed):** Cleaner configuration, framework-neutral loader, configurable initial theme, improved Markdown rendering, and a refreshed composer, trigger, and playground UI. - - **Pre-filled contact form:** When the assistant hands off to support, it now pre-fills the contact form message from the conversation so users don't have to re-explain their issue. - - **ChatGPT MCP connector:** Add Mintlify docs as a [ChatGPT connector](/ai/mintlify-mcp) so ChatGPT can search and cite your documentation. - - **Claude in automations:** Automations now support Claude as a model provider. - - ## Automations and Slack agent + ## Automations, integrations, and Slack - - **Automation analytics dashboard:** A new analytics view for [automations](/automations) with per-workflow run history, outcomes, and trends. - - **Composio integrations:** Third-party integrations for automations are now powered by Composio, with a shared connect flow across the dashboard and Slack agent. - - **Integration triggers:** Trigger automations from third-party events (for example, a Slack message or a support ticket update) via [Composio triggers](/automations/integrations). - - **User-scoped integrations:** Connect third-party tools under your own account and pick them from the automations picker, alongside org-wide connections. - - **One-shot scheduled workflows:** Schedule an automation to run once at a future time and auto-delete after it finishes. - - **Filtered changelog URLs:** Share a [changelog](/changelog) link filtered to a specific tag. + - **Shared and personal integrations:** Give the Slack agent and automations read-only context from shared tools, or connect a personal account for the agent to use when you chat with it. See [integrations](/automations/integrations). + - **Integration triggers:** On Enterprise plans, trigger automations from third-party events such as a support ticket update. - **Slack agent reads PR activity:** The [Slack agent](/agent/slack) now reads PR comments, reviews, and CI checks, and follows up in the thread after reverting a change based on feedback. - ## CLI - - - **`mint format`:** Format MDX files with Mintlify's bundled editor converter for consistent structure across your docs. See [CLI commands](/cli/commands). - - **`mint deslop`:** Detect AI-sounding prose and get humanization suggestions before publishing. - - **`mint add-domain`:** Configure a [custom domain](/customize/custom-domain) from the CLI without leaving your terminal. - - **Nicer `--help` output:** Consistent `--help` formatting across every command and a friendlier prompt when the CLI is invoked by an AI agent. - - ## Analytics + ## Analytics and data streaming - - **Feedback revamp:** The [analytics feedback](/optimize/feedback) section now surfaces per-page ratings and opens a detailed feedback drawer with the underlying comments. - - **Human vs. agent page rankings:** Page rankings now split human and agent traffic into separate columns so you can see who's really reading each page. - - **Analytics streaming config:** Pick which deployments to include when [streaming analytics](/optimize/analytics) to your own warehouse. + - **Analytics data warehouse streaming:** On Enterprise plans, stream analytics events to Amazon S3 in near real time, with controls for which event categories and deployments to include. See [analytics streaming](/optimize/analytics#stream-analytics-events). + - **Audit log streaming:** On Enterprise plans, stream audit events to Amazon S3 or Datadog for security monitoring and long-term retention. See [audit logs](/dashboard/audit-logs#stream-audit-logs). + - **Automation analytics dashboard:** A new analytics view for [automations](/automations) with metrics on pull requests and credit use. - ## Deployments and search + ## Sites, deployments, and performance - - **Search on preview deployments:** Preview deployments now serve docs search, so you can validate search results before merging. - - **Deep-link PR previews:** GitHub PR preview links now open directly on the page you changed. - - **GHES repo selection:** Self-hosted GitHub Enterprise Server repositories can now be selected in [git settings](/deploy/ghes). - - **Ignore `.mintlify` by default:** The `.mintlify` directory is ignored on deploy by default, except for `skills` and `specs`. + - **Smaller navigation payloads:** Pages now load only the navigation data they need, improving performance most noticeably for large sites with multiple products, versions, or languages. + - **Better previews:** Preview deployments now serve search results. GitHub PR preview links open directly on the page you changed. + - **Deployment setup:** Use `mint add-domain` to configure a [custom domain](/customize/custom-domain) from the CLI. + - **`mint signup`:** Create a Mintlify account from the terminal, including agent-driven CLI workflows. See [CLI commands](/cli/commands#mint-signup). + - **Publishing controls:** Share a [changelog](/changelog) filtered to a specific tag, and ignore `.mintlify` during deploys by default except for `skills` and `specs`. + - **Simpler file trees:** Write [`FileTree`](/components/tree) components as nested Markdown lists to document folder structures with less markup. ## Bug fixes - - Search domain path casing is preserved end-to-end. - - Fuzzy search now only falls back to near-typo matches instead of loose fuzzy hits. - - Stuck search indexing jobs are recovered by a new watchdog, and search AST uploads retry on transient S3 failures instead of silently dropping pages. - - Search emits per-context version and product tags for pages that are cross-listed across contexts. - - Preview builds now surface branch deletion clearly instead of showing a misleading build error. - - The editor now round-trips task list checkboxes, table escapes, LaTeX math, callout `type` attributes, video sources, image titles, and inline code with pipes inside table cells. - - The editor allows block content inside `Columns` so nested blocks don't get silently deleted. - - PDF exports are now rendered in light mode regardless of the reader's theme. - - `.md` page internal links and the `Link` header respect your `basePath`. - - Authenticated docs correctly refresh expired end-user JWTs in the search proxy and serve a genuine 404 for missing pages on allowlisted deployments. - - The Assistant Widget waits for hCaptcha to be ready before submitting and preserves historical response actions across reloads. - - Subpath domain setup preserves its pending state during DNS provisioning and hides the DNS migration step where it doesn't apply. - - The `luma` and `sequoia` themes correctly center content in center page mode, and the `maple` theme keeps the API side panel below the tabs navigation. - - Duplicate page names in the dashboard now append a slug instead of colliding, and the products redirect preserves the authentication segment. - - Password auth renders read-only when unentitled instead of crashing the settings page. + - **Search reliability:** Search preserves domain path casing, limits fuzzy fallback to near-typo matches, recovers stuck indexing jobs, retries transient uploads, and correctly tags pages listed across multiple products or versions. + - **Editor fidelity:** The editor preserves task lists, table escapes, LaTeX, callout types, video sources, image titles, inline code containing pipes, and block content nested in `Columns`. + - **Authenticated sites:** Search refreshes expired end-user JWTs, missing pages return genuine 404 responses, and password-auth settings render read-only when the feature is not entitled. + - **Previews, links, exports, and domains:** Preview builds surface branch deletion clearly, internal `.md` links respect `basePath`, PDF exports render in light mode, and subpath domain setup preserves its pending state while DNS is provisioning. + - **Themes and dashboard routing:** Center page mode works correctly in the `luma` and `sequoia` themes. The `maple` API side panel stays below tabs navigation. Duplicate page names no longer collide. Product redirects preserve authentication paths. From 73ffe313b29bdba17cf201d1f545a132c8488940 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Fri, 24 Jul 2026 13:19:28 -0700 Subject: [PATCH 4/4] translations --- es/changelog.mdx | 93 +++++++++++++++--------------------------------- fr/changelog.mdx | 93 +++++++++++++++--------------------------------- zh/changelog.mdx | 93 +++++++++++++++--------------------------------- 3 files changed, 87 insertions(+), 192 deletions(-) diff --git a/es/changelog.mdx b/es/changelog.mdx index 0afe19032a..af8e0744ee 100644 --- a/es/changelog.mdx +++ b/es/changelog.mdx @@ -5,94 +5,59 @@ rss: true noindex: true --- - + -
- ## Referencias de API y SDK +
+ ## Referencias GraphQL y SDK
- **Páginas de referencia de API de GraphQL:** Genera páginas de referencia a partir de un esquema SDL de GraphQL, con tipos enlazados y ejemplos de queries, mutations y respuestas. Consulta [Configuración de GraphQL](/es/api-playground/graphql-setup). - **Generación de referencias de SDK:** Crea páginas de referencia de SDK directamente desde la salida de TypeDoc, DocFX, Javadoc, Sphinx o phpDocumentor. Consulta [Configuración de la referencia de SDK](/es/api-playground/sdk-reference-setup). -
- ## Editor +
+ ## Editor y colaboración
- **Flujo de revisión:** Solicita la revisión de un borrador, deja comentarios y aprueba o solicita cambios antes de publicar. Las revisiones ahora admiten ramas que no son de despliegue. - - **El agente del editor lee tus repos de código:** Otorga al [agente del editor](/es/editor/agent) acceso de solo lectura a los repositorios de código conectados para que pueda fundamentar las ediciones de la documentación en tu código fuente. - - **Comentarios de página de nivel superior:** Inicia un hilo de comentarios sobre la propia página, no solo sobre el texto seleccionado. - - **Menciónate en los comentarios:** Usa `@`-mención a tu propia cuenta en los [comentarios del editor](/es/editor/comments) para dejarte recordatorios. - - **Nuevos atajos de teclado:** `Option+S` abre una [sugerencia](/es/editor/suggestions) sobre el texto seleccionado y `Option+C` abre un [comentario](/es/editor/comments). - - **El cursor se enfoca al inicio al abrir:** Abrir una página ahora coloca el cursor al inicio del documento. - - **Carga más rápida:** El editor ya no espera al árbol de archivos de git para renderizarse. - - **Vista sin permisos de GitHub:** Los usuarios sin acceso de escritura al repositorio ahora pueden abrir el editor en modo de solo lectura en lugar de quedar bloqueados. - -
- ## Asistente y widget -
+ - **Más formas de colaborar:** Inicia [hilos de comentarios](/es/editor/comments) sobre una página completa, menciónate para dejar un recordatorio y usa los atajos de teclado Option + C u Option + S para comentar o sugerir cambios en el texto seleccionado. + - **Edición más rápida y disponible:** El editor se renderiza sin esperar al árbol de archivos de Git y las personas sin acceso de escritura en GitHub pueden usarlo. - - **[Assistant Widget](/es/guides/assistant-embed) simplificado:** Configuración más limpia, cargador neutral respecto al framework, tema inicial configurable, renderizado mejorado de Markdown y una UI renovada del compositor, disparador y playground. - - **Formulario de contacto prellenado:** Cuando el asistente deriva al soporte, ahora prellena el mensaje del formulario de contacto a partir de la conversación para que los usuarios no tengan que volver a explicar su problema. - - **Conector MCP de ChatGPT:** Añade la documentación de Mintlify como [conector de ChatGPT](/es/ai/mintlify-mcp) para que ChatGPT pueda buscar y citar tu documentación. - - **Claude en automations:** Las automations ahora admiten Claude como proveedor de modelos. - -
- ## Automations y agente de Slack +
+ ## Automations, integraciones y Slack
- - **Dashboard de analytics de automations:** Una nueva vista de analytics para [automations](/es/automations) con historial de ejecuciones, resultados y tendencias por flujo. - - **Integraciones de Composio:** Las integraciones de terceros para automations ahora funcionan con Composio, con un flujo de conexión compartido entre el dashboard y el agente de Slack. - - **Disparadores de integraciones:** Activa automations a partir de eventos de terceros (por ejemplo, un mensaje de Slack o la actualización de un ticket de soporte) mediante [disparadores de Composio](/es/automations/integrations). - - **Integraciones con alcance de usuario:** Conecta herramientas de terceros bajo tu propia cuenta y selecciónalas desde el selector de automations, junto con las conexiones a nivel de organización. - - **Flujos programados de una sola ejecución:** Programa una automation para que se ejecute una vez en el futuro y se elimine automáticamente al finalizar. - - **URLs filtradas del changelog:** Comparte un enlace del [changelog](/es/changelog) filtrado por una etiqueta específica. + - **Integraciones compartidas y personales:** Proporciona al agente de Slack y a las automations contexto de solo lectura desde herramientas compartidas, o conecta una cuenta personal para que el agente la use cuando converses con él. Consulta [Integraciones](/es/automations/integrations). + - **Disparadores de integraciones:** En los planes Enterprise, activa automations a partir de eventos de terceros, como la actualización de un ticket de soporte. - **El agente de Slack lee la actividad de PRs:** El [agente de Slack](/es/agent/slack) ahora lee los comentarios de PR, las revisiones y los checks de CI, y da seguimiento en el hilo después de revertir un cambio a partir del feedback. -
- ## CLI -
- - - **`mint format`:** Formatea archivos MDX con el conversor de editor integrado de Mintlify para lograr una estructura consistente en toda tu documentación. Consulta [Comandos de la CLI](/es/cli/commands). - - **`mint deslop`:** Detecta prosa con tono de IA y obtén sugerencias de humanización antes de publicar. - - **`mint add-domain`:** Configura un [dominio personalizado](/es/customize/custom-domain) desde la CLI sin salir de tu terminal. - - **Salida de `--help` más agradable:** Formato consistente de `--help` en todos los comandos y un mensaje más amable cuando la CLI es invocada por un agente de IA. - -
- ## Analytics +
+ ## Analytics y streaming de datos
- - **Feedback renovado:** La sección de [feedback de analytics](/es/optimize/feedback) ahora muestra las valoraciones por página y abre un panel detallado de feedback con los comentarios subyacentes. - - **Rankings de páginas humano vs. agente:** Los rankings de páginas ahora separan el tráfico humano y el de agentes en columnas distintas para que puedas ver quién está leyendo realmente cada página. - - **Configuración de streaming de analytics:** Elige qué despliegues incluir cuando hagas [streaming de analytics](/es/optimize/analytics) a tu propio warehouse. + - **Streaming de analytics al data warehouse:** En los planes Enterprise, transmite eventos de analytics a Amazon S3 casi en tiempo real y controla qué categorías de eventos y despliegues incluir. Consulta [Streaming de analytics](/es/optimize/analytics#stream-analytics-events). + - **Streaming de registros de auditoría:** En los planes Enterprise, transmite eventos de auditoría a Amazon S3 o Datadog para el monitoreo de seguridad y la retención a largo plazo. Consulta [Registros de auditoría](/es/dashboard/audit-logs#stream-audit-logs). + - **Dashboard de analytics de automations:** Una nueva vista de analytics para [automations](/es/automations) con métricas sobre pull requests y uso de créditos. -