From 635fc553797588fc66943d111e750278dcb6dda2 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 29 May 2026 17:43:38 +0000 Subject: [PATCH 1/3] docs: add May 29, 2026 changelog entry --- changelog.mdx | 55 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 55 insertions(+) diff --git a/changelog.mdx b/changelog.mdx index e92b27282e..b92a5b134a 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -5,6 +5,61 @@ rss: true noindex: true --- + + ## Editor + + More ways to edit and configure your docs directly from the [web editor](https://www.mintlify.com/docs/editor): + + - **Visual `docs.json` editor:** A redesigned configuration editor lets you edit `docs.json` visually and sync changes back to the navigation tree. + - **Frontmatter panel:** A new file frontmatter panel in the file explorer view lets you view and edit page metadata without leaving the tree. + - **Hide branches toggle:** A new toggle hides branch indicators in the editor view for a cleaner workspace. + - **Better link editing:** Editing inline links is faster with an improved link editor experience. + - **Fullscreen table mode:** Edit large tables in a dedicated fullscreen view. + - **Drag and drop Markdown:** You can now drag and drop Markdown files into the editor to upload them. + - **Brand icons in icon picker:** Brand icons are now available alongside the rest of the icon library. + + ## Editor agent + + - **Searches Mintlify docs:** The editor agent can now search the Mintlify documentation to ground its answers and edits. + - **Edit and delete non-docs files:** The agent can manage non-docs files in your repository in addition to pages. + - **File attachments:** Attach files directly to the agent — they're sent through the API rather than inlined in the prompt. + - **Interrupt mid-stream:** Stop the agent while it's streaming a response if you want to redirect it. + + ## Workflows + + - **Improve docs from feedback** is now a dedicated workflow that reviews recent [page feedback](https://www.mintlify.com/docs/optimize/feedback) and opens targeted documentation updates from what users report. See [Workflows](https://www.mintlify.com/docs/workflows/enable#improve-docs-from-feedback). + - The **Sync content with code** workflow has been renamed to **Self-updating site** to better reflect what it does. + - Workflow titles and copy across the dashboard have been refreshed for clarity. + + ## API playground + + - **Callbacks on API reference pages:** OpenAPI `callbacks` now render on API reference pages so readers can see the requests your API sends back. See [OpenAPI setup](https://www.mintlify.com/docs/api-playground/openapi-setup). + - **Download API spec:** A new **Download API spec** option is available from the page context menu on API reference pages. + + ## Dashboard + + - **Switch organizations without signing out:** You can now move between organizations in a single click. No more re-authenticating to switch contexts. + + ## AI and MCP + + - **MCP server card:** Mintlify now serves an MCP server card at the well-known paths MCP scanners probe, including server info and customer name, making it easier for clients to discover your [MCP server](https://www.mintlify.com/docs/ai/model-context-protocol). + - **Content-Signal directives:** Tenant `robots.txt` files now include Content-Signal directives to communicate AI usage preferences to crawlers. + - **Snippet variables in code blocks:** [Reusable snippets](https://www.mintlify.com/docs/create/reusable-snippets) now support variables inside code blocks, so you can parameterize examples consistently. + + ## Bug fixes + + - Custom heading IDs now preserve casing (camelCase, snake_case, kebab-case). + - Navigation breadcrumbs render above page-level hits in search results. + - Enum defaults pre-populate when you add new array items in the API playground. + - `.xml` files are now treated as valid link targets by the broken-links checker. + - Changelog pages now include an RSS feed discovery meta tag so readers can subscribe directly from the page. + - Bullet point behavior in the editor is fixed, including continuing and exiting lists. + - Pasting copied web images no longer creates duplicate broken image nodes. + - Large editor media uploads now use direct-to-S3 presigned URLs, bypassing the previous 4.5 MB function payload limit. + - GitHub edit links now work correctly for `.md` pages. + - Slash commands and the file settings sheet behave correctly in the file tree. + + ## Web Editor From f5a1fd8520f3d86cfe1b9882a90812cb1d77df56 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 29 May 2026 17:45:46 +0000 Subject: [PATCH 2/3] docs: translate May 29, 2026 changelog entry to es and fr --- es/changelog.mdx | 70 ++++++++++++++++++++++++++++++++++++++++++++++++ fr/changelog.mdx | 70 ++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 140 insertions(+) diff --git a/es/changelog.mdx b/es/changelog.mdx index c5b25a8828..6711e0ca7b 100644 --- a/es/changelog.mdx +++ b/es/changelog.mdx @@ -5,6 +5,76 @@ rss: true noindex: true --- + + +
+ ## Editor +
+ + Más formas de editar y configurar tus docs directamente desde el [editor web](/es/editor): + + - **Editor visual de `docs.json`:** Un editor de configuración rediseñado te permite editar `docs.json` visualmente y sincronizar los cambios con el árbol de navegación. + - **Panel de frontmatter:** Un nuevo panel de frontmatter en la vista del explorador de archivos te permite ver y editar los metadatos de la página sin salir del árbol. + - **Alternar para ocultar ramas:** Una nueva opción oculta los indicadores de rama en la vista del editor para un espacio de trabajo más limpio. + - **Mejor edición de enlaces:** Editar enlaces en línea es más rápido gracias a una experiencia mejorada del editor de enlaces. + - **Modo pantalla completa para tablas:** Edita tablas grandes en una vista dedicada en pantalla completa. + - **Arrastrar y soltar Markdown:** Ahora puedes arrastrar y soltar archivos Markdown en el editor para subirlos. + - **Iconos de marca en el selector de iconos:** Los iconos de marca ya están disponibles junto con el resto de la biblioteca de iconos. + +
+ ## Agente del editor +
+ + - **Busca en la documentación de Mintlify:** El agente del editor ahora puede buscar en la documentación de Mintlify para fundamentar sus respuestas y ediciones. + - **Editar y eliminar archivos que no son docs:** El agente puede gestionar archivos que no son de documentación en tu repositorio, además de las páginas. + - **Archivos adjuntos:** Adjunta archivos directamente al agente — se envían a través de la API en lugar de incrustarse en el prompt. + - **Interrumpir en medio del streaming:** Detén al agente mientras transmite una respuesta si quieres redirigirlo. + +
+ ## Workflows +
+ + - **Mejora la documentación a partir del feedback** ahora es un workflow dedicado que revisa los [comentarios recientes de las páginas](/es/optimize/feedback) y abre actualizaciones específicas de documentación a partir de lo que reportan los usuarios. Consulta [Workflows](/es/workflows/enable#improve-docs-from-feedback). + - El workflow **Sync content with code** ha sido renombrado a **Self-updating site** para reflejar mejor lo que hace. + - Se actualizaron los títulos y los textos de los workflows en el panel para mayor claridad. + +
+ ## API playground +
+ + - **Callbacks en las páginas de referencia de la API:** Los `callbacks` de OpenAPI ahora se muestran en las páginas de referencia de la API para que los lectores puedan ver las solicitudes que tu API envía de vuelta. Consulta [Configuración de OpenAPI](/es/api-playground/openapi-setup). + - **Descargar la especificación de la API:** Una nueva opción **Download API spec** está disponible en el menú contextual de la página en las páginas de referencia de la API. + +
+ ## Panel +
+ + - **Cambia de organización sin cerrar sesión:** Ahora puedes pasar de una organización a otra con un solo clic. Ya no es necesario volver a autenticarse para cambiar de contexto. + +
+ ## IA y MCP +
+ + - **Tarjeta del servidor MCP:** Mintlify ahora sirve una tarjeta de servidor MCP en las rutas well-known que los escáneres MCP sondean, incluyendo información del servidor y el nombre del cliente, lo que facilita a los clientes descubrir tu [servidor MCP](/es/ai/model-context-protocol). + - **Directivas Content-Signal:** Los archivos `robots.txt` de cada tenant ahora incluyen directivas Content-Signal para comunicar las preferencias de uso de IA a los rastreadores. + - **Variables de snippet en bloques de código:** Los [snippets reutilizables](/es/create/reusable-snippets) ahora admiten variables dentro de los bloques de código, para que puedas parametrizar los ejemplos de forma consistente. + +
+ ## Correcciones de errores +
+ + - Los IDs de encabezado personalizados ahora conservan las mayúsculas (camelCase, snake_case, kebab-case). + - Las migas de pan de navegación se muestran encima de los resultados a nivel de página en los resultados de búsqueda. + - Los valores predeterminados de los enums se rellenan automáticamente al agregar nuevos elementos de array en el API playground. + - Los archivos `.xml` ahora se tratan como destinos de enlace válidos por el verificador de enlaces rotos. + - Las páginas del registro de cambios ahora incluyen una metaetiqueta de descubrimiento de feed RSS para que los lectores puedan suscribirse directamente desde la página. + - Se corrigió el comportamiento de las viñetas en el editor, incluida la continuación y la salida de listas. + - Pegar imágenes copiadas de la web ya no crea nodos de imagen rotos duplicados. + - Las cargas grandes de medios del editor ahora usan URLs prefirmadas directamente a S3, evitando el límite anterior de 4,5 MB en la carga útil de la función. + - Los enlaces de edición de GitHub ahora funcionan correctamente para las páginas `.md`. + - Los comandos de barra y la hoja de configuración de archivos se comportan correctamente en el árbol de archivos. + +
diff --git a/fr/changelog.mdx b/fr/changelog.mdx index 7aed992d50..8b21152fc8 100644 --- a/fr/changelog.mdx +++ b/fr/changelog.mdx @@ -5,6 +5,76 @@ rss: true noindex: true --- + + +
+ ## Éditeur +
+ + Davantage de façons d'éditer et de configurer votre documentation directement depuis l'[éditeur web](/fr/editor) : + + - **Éditeur visuel de `docs.json` :** Un éditeur de configuration repensé vous permet de modifier `docs.json` visuellement et de synchroniser les changements avec l'arborescence de navigation. + - **Panneau de frontmatter :** Un nouveau panneau de frontmatter dans la vue de l'explorateur de fichiers vous permet de consulter et de modifier les métadonnées de la page sans quitter l'arborescence. + - **Basculement pour masquer les branches :** Une nouvelle option masque les indicateurs de branche dans la vue de l'éditeur pour un espace de travail plus clair. + - **Meilleure édition des liens :** L'édition des liens en ligne est plus rapide grâce à une expérience d'édition de liens améliorée. + - **Mode plein écran pour les tableaux :** Modifiez les grands tableaux dans une vue plein écran dédiée. + - **Glisser-déposer Markdown :** Vous pouvez désormais glisser-déposer des fichiers Markdown dans l'éditeur pour les téléverser. + - **Icônes de marque dans le sélecteur d'icônes :** Les icônes de marque sont désormais disponibles aux côtés du reste de la bibliothèque d'icônes. + +
+ ## Agent de l'éditeur +
+ + - **Recherche dans la documentation Mintlify :** L'agent de l'éditeur peut désormais effectuer des recherches dans la documentation Mintlify pour étayer ses réponses et ses modifications. + - **Modifier et supprimer des fichiers hors documentation :** L'agent peut gérer les fichiers hors documentation de votre dépôt en plus des pages. + - **Pièces jointes :** Joignez des fichiers directement à l'agent — ils sont envoyés via l'API au lieu d'être intégrés dans le prompt. + - **Interruption en cours de flux :** Arrêtez l'agent pendant qu'il diffuse une réponse si vous souhaitez le réorienter. + +
+ ## Workflows +
+ + - **Améliorer la documentation à partir des retours** est désormais un workflow dédié qui examine les [retours récents sur les pages](/fr/optimize/feedback) et ouvre des mises à jour ciblées de la documentation à partir de ce que rapportent les utilisateurs. Voir [Workflows](/fr/workflows/enable#improve-docs-from-feedback). + - Le workflow **Sync content with code** a été renommé en **Self-updating site** pour mieux refléter sa fonction. + - Les titres et le contenu des workflows dans le tableau de bord ont été retravaillés pour plus de clarté. + +
+ ## API playground +
+ + - **Callbacks sur les pages de référence de l'API :** Les `callbacks` OpenAPI s'affichent désormais sur les pages de référence de l'API afin que les lecteurs puissent voir les requêtes envoyées en retour par votre API. Voir [Configuration OpenAPI](/fr/api-playground/openapi-setup). + - **Télécharger la spécification de l'API :** Une nouvelle option **Download API spec** est disponible dans le menu contextuel des pages de référence de l'API. + +
+ ## Tableau de bord +
+ + - **Changer d'organisation sans se déconnecter :** Vous pouvez désormais passer d'une organisation à une autre en un seul clic. Plus besoin de se réauthentifier pour changer de contexte. + +
+ ## IA et MCP +
+ + - **Carte du serveur MCP :** Mintlify fournit désormais une carte de serveur MCP aux chemins well-known sondés par les scanners MCP, incluant les informations du serveur et le nom du client, ce qui facilite la découverte de votre [serveur MCP](/fr/ai/model-context-protocol) par les clients. + - **Directives Content-Signal :** Les fichiers `robots.txt` de chaque tenant incluent désormais des directives Content-Signal pour communiquer les préférences d'utilisation par l'IA aux robots d'exploration. + - **Variables de snippet dans les blocs de code :** Les [snippets réutilisables](/fr/create/reusable-snippets) prennent désormais en charge les variables à l'intérieur des blocs de code, afin que vous puissiez paramétrer les exemples de manière cohérente. + +
+ ## Corrections de bugs +
+ + - Les ID d'en-tête personnalisés conservent désormais la casse (camelCase, snake_case, kebab-case). + - Les fils d'Ariane de navigation s'affichent au-dessus des résultats au niveau de la page dans les résultats de recherche. + - Les valeurs par défaut des enums sont pré-remplies lors de l'ajout de nouveaux éléments de tableau dans l'API playground. + - Les fichiers `.xml` sont désormais considérés comme des cibles de lien valides par le vérificateur de liens rompus. + - Les pages du journal des modifications incluent désormais une balise meta de découverte de flux RSS pour que les lecteurs puissent s'abonner directement depuis la page. + - Le comportement des puces dans l'éditeur a été corrigé, y compris la poursuite et la sortie des listes. + - Coller des images copiées sur le web ne crée plus de nœuds d'image rompus en double. + - Les téléversements de médias volumineux dans l'éditeur utilisent désormais des URL présignées vers S3, contournant la limite précédente de charge utile de fonction de 4,5 Mo. + - Les liens d'édition GitHub fonctionnent désormais correctement pour les pages `.md`. + - Les commandes slash et la feuille de paramètres de fichier se comportent correctement dans l'arborescence des fichiers. + +
From 74ad80ef0152ccd12fc8c9db08b5545df9977067 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Fri, 29 May 2026 11:32:23 -0700 Subject: [PATCH 3/3] =?UTF-8?q?=F0=9F=92=85?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- changelog.mdx | 39 +++++++++++++++++++++++++-------------- 1 file changed, 25 insertions(+), 14 deletions(-) diff --git a/changelog.mdx b/changelog.mdx index b92a5b134a..d9db9c94c6 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -5,13 +5,13 @@ rss: true noindex: true --- - + ## Editor More ways to edit and configure your docs directly from the [web editor](https://www.mintlify.com/docs/editor): - **Visual `docs.json` editor:** A redesigned configuration editor lets you edit `docs.json` visually and sync changes back to the navigation tree. - - **Frontmatter panel:** A new file frontmatter panel in the file explorer view lets you view and edit page metadata without leaving the tree. + - **Page settings panel:** The new page settings panel lets you view and edit frontmatter in the file explorer view. - **Hide branches toggle:** A new toggle hides branch indicators in the editor view for a cleaner workspace. - **Better link editing:** Editing inline links is faster with an improved link editor experience. - **Fullscreen table mode:** Edit large tables in a dedicated fullscreen view. @@ -20,31 +20,42 @@ noindex: true ## Editor agent - - **Searches Mintlify docs:** The editor agent can now search the Mintlify documentation to ground its answers and edits. - - **Edit and delete non-docs files:** The agent can manage non-docs files in your repository in addition to pages. - - **File attachments:** Attach files directly to the agent — they're sent through the API rather than inlined in the prompt. + - **Searches Mintlify docs:** The agent can now search the Mintlify documentation while you work in the editor, so you're always connected to the source of truth for Mintlify while updating content. + - **Edit and delete non-content files:** The agent can manage non-content files in your repository in addition to pages. + - **File attachments:** Attach files directly to the agent. - **Interrupt mid-stream:** Stop the agent while it's streaming a response if you want to redirect it. ## Workflows - - **Improve docs from feedback** is now a dedicated workflow that reviews recent [page feedback](https://www.mintlify.com/docs/optimize/feedback) and opens targeted documentation updates from what users report. See [Workflows](https://www.mintlify.com/docs/workflows/enable#improve-docs-from-feedback). - - The **Sync content with code** workflow has been renamed to **Self-updating site** to better reflect what it does. + - **Draft improvements from user feedback:** This new workflow reviews recent [page feedback](/optimize/feedback) and opens pull requests based on what users report. + - The **update from code changes** workflow (formerly sync content with code) defaults to run on a schedule rather than triggering on every code change. When it runs, the agent scans all code changes since the last run and opens one PR per related set of documentation updates. If a PR is still open from a previous workflow run, new changes are appended to it rather than creating a new PR. This means a release worked on over several weeks produces a single docs PR to review instead of one per commit. - Workflow titles and copy across the dashboard have been refreshed for clarity. ## API playground - - **Callbacks on API reference pages:** OpenAPI `callbacks` now render on API reference pages so readers can see the requests your API sends back. See [OpenAPI setup](https://www.mintlify.com/docs/api-playground/openapi-setup). - - **Download API spec:** A new **Download API spec** option is available from the page context menu on API reference pages. + - **Callbacks on API reference pages:** OpenAPI `callbacks` now render on API reference pages so readers can see the requests your API sends back. + - **Download API spec:** A new **Download API spec** option is available from the contextual menu on API reference pages. - ## Dashboard + ## Admin MCP - - **Switch organizations without signing out:** You can now move between organizations in a single click. No more re-authenticating to switch contexts. + Agents that connect to the admin MCP can now read and modify most dashboard settings directly. This lets you configure your entire Mintlify setup without touching the dashboard and gives AI agents direct access to your analytics data. Supported operations include: - ## AI and MCP + - Enabling and disabling workflows + - Creating custom workflows + - Managing authentication settings + - Configuring custom domains + - Reading and analyzing analytics data - - **MCP server card:** Mintlify now serves an MCP server card at the well-known paths MCP scanners probe, including server info and customer name, making it easier for clients to discover your [MCP server](https://www.mintlify.com/docs/ai/model-context-protocol). + ## Agent discoverability + + - **MCP server card:** Mintlify now serves an MCP server card at the well-known paths MCP scanners probe, including server info and customer name, making it easier for clients to discover your MCP server. - **Content-Signal directives:** Tenant `robots.txt` files now include Content-Signal directives to communicate AI usage preferences to crawlers. - - **Snippet variables in code blocks:** [Reusable snippets](https://www.mintlify.com/docs/create/reusable-snippets) now support variables inside code blocks, so you can parameterize examples consistently. + - **AI discoverability for partially authenticated sites:** Deployments with [partial authentication](/deploy/authentication-setup) now serve `sitemap.xml`, `llms.txt`, `llms-full.txt`, and `robots.txt` publicly, so AI crawlers and agents can discover your content even when parts of your site require authentication. + + ## Improvements + + - Switch organizations without signing out: You can now move between organizations with one click. No more re-authenticating to switch projects. + - Snippet variables in code blocks: [Reusable snippets](/create/reusable-snippets) now support variables inside code blocks, so you can parameterize examples consistently. ## Bug fixes