Actualizaciones del producto

​

Novedades

• Navegación de productos: Organiza la documentación de varios productos con el conmutador de productos en la navegación
• Comando de CLI de accesibilidad: Ejecuta mint a11y para probar tu documentación en busca de problemas de accesibilidad
• Respuestas de video en el área de pruebas de la API: El área de pruebas de la API ahora admite la visualización de tipos de respuesta en video
• Autorrelleno del área de pruebas de la API: Nueva opción para autorrellenar ejemplos en el área de pruebas de la API para agilizar las pruebas
• Comentarios sin autenticación: En sitios con autenticación parcial, los usuarios ahora pueden enviar comentarios sin autenticarse
• Compatibilidad con temas de Shiki: Ya se admiten temas de Shiki para el estilo de los bloques de código
• Twoslash para bloques de código: Los bloques de código de TypeScript y JavaScript ahora admiten Twoslash para información de tipos en línea

​

Mejoras de accesibilidad

• Se añadieron atributos ARIA completos en todos los componentes para mejorar la compatibilidad con lectores de pantalla
• Nuevo botón “saltar al contenido principal” para la navegación con teclado
• Compatibilidad con navegación mediante teclas de flecha en componentes de pestañas
• Mejora de los tooltips, las listas anidadas y la accesibilidad de los grupos de código
• Mejora de los estados de enfoque y de los patrones de interacción con teclado en toda la interfaz

​

Mejoras del assistant y de Analytics

• Se añadió visualización de gráficos de barras para las búsquedas del assistant en Analytics
• Selector de rango de fechas unificado en la página de Analytics del assistant
• Controles de zoom para los gráficos de Analytics del assistant
• Mejor gestión del historial del assistant con atajos de teclado y mejoras en la hoja de chat

​

Corrección de errores y confiabilidad

• Se solucionaron problemas de z-index con superposiciones del panel lateral
• Se corrigieron colores de respaldo en modo claro y errores de estilo relacionados con el tema
• Se corrigió que los desplegables del área de pruebas de la API no funcionaran con enlaces ancla
• Se mejoró la accesibilidad de enlaces .md para ChatGPT y otros agentes de LLM
• Se corrigió el manejo de dimensiones de imágenes para anchos y altos basados en porcentajes
• Se corrigieron problemas de renderizado de bloques de código con etiquetas de idioma y temas personalizados
• Se corrigió el formato y el estilo de enlaces en acordeones
• Se corrigió el espaciado del pie de página cuando la configuración del assistant está vacía
• Se corrigió el renderizado de iconos de tarjeta para imágenes locales del repositorio
• Se corrigió el manejo de archivos de audio en el área de pruebas de la API (se evitó la decodificación UTF-8)
• Se mejoró la gestión del estado de publicación de PR en el editor web

​

Ampliación del soporte de idiomas

• Se añadió compatibilidad con los idiomas rumano y checo en la interfaz de la documentación
• Capacidades de localización mejoradas con cobertura de traducción completa para los nuevos idiomas
• Mejoras en la funcionalidad del selector de idioma en todos los temas

​

Mejoras de la interfaz de usuario y de la experiencia

• Se solucionaron problemas de visibilidad de pestañas en páginas 404 para evitar resaltar de forma incorrecta la pestaña activa
• Manejo de imágenes mejorado con paso correcto de los atributos width y height para imágenes no optimizadas
• Mejora del diseño y la consistencia de estilo de la página 404

​

Mejoras de infraestructura y rendimiento

• Procesamiento de imágenes GIF mejorado al omitir el costoso autoformato de Imgix para reducir el tiempo de procesamiento y el uso de ancho de banda
• Rendimiento de entrega de imágenes optimizado con manejo especial para contenido animado

​

Corrección de errores y confiabilidad

• Se corrigió el enrutamiento del correo de contacto en la configuración del dashboard para solicitudes del complemento assistant
• Mejoras en las actualizaciones del esquema de base de datos para una mejor gestión de usuarios

​

Mejoras en el editor web y el inicio de sesión del dashboard

• Avance en la migración al app router para el editor web, eliminando bloqueadores y mejorando el rendimiento
• Manejo de errores de inicio de sesión mejorado con mensajes explícitos de validación de correo electrónico
• Corrección del manejo de espacios en blanco en la validación de direcciones de correo electrónico

​

Mejoras de Autenticación

• Se añadió compatibilidad con parámetros de redirección validados en la devolución de llamada de inicio de sesión para reducir la fricción
• Flujo de inicio de sesión mejorado para SSO con un mejor manejo de redirecciones

​

Corrección de errores y confiabilidad

• Se solucionaron problemas de integración con GitLab en repositorios más grandes
• Se mejoró el rendimiento de carga del dashboard con consultas de implementación optimizadas
• Se corrigieron problemas de renderizado de rutas SVG en la documentación
• Se corrigió la navegación con teclado en la búsqueda y en la funcionalidad de chat

​

Lanzamientos principales

• Mejora importante: Páginas sugeridas por IA en páginas 404, cuando alguien llega a un enlace roto → el agente de IA lee la ruta → sugiere páginas semánticamente similares
• Lanzamiento importante: la búsqueda web para el assistant ahora puede incluir fuentes externas
  Nota: Contáctanos para habilitar esta función en tu sitio.

​

Assistant y MCP

• Se corrigió un error donde el assistant era limitado por tasa de forma incorrecta debido a que la ventana de tiempo no se deslizaba correctamente
• Se corrigió un error con la llamada a herramientas del assistant para manejar correctamente bloques text vacíos
• Se corrigió un error donde el nombre del servidor MCP concatenado con llamadas a herramientas a veces superaba el límite de 60 caracteres que imponen los clientes MCP
• Se corrigió un error donde el menú del assistant tenía una altura varias veces mayor que el viewport y hacía scroll indefinidamente
• Se corrigió un error donde los valores de gasto del assistant podían mostrarse con más de dos decimales en el dashboard

​

Editor web e implementaciones

• Mejora de seguridad añadida al editor, de modo que solo los usuarios con write permissions en el repositorio de alojamiento de Git conectado puedan hacer cambios
• Se corrigió un error donde las implementaciones de vista previa no funcionaban para branches con = en el nombre
• Se corrigió un error donde los nombres de branch largos desbordaban los modales al crear implementaciones de vista previa
• Mejora de usabilidad: el parámetro de búsqueda de email ahora completa previamente el campo en invitaciones de registro
• Se corrigió un error donde copiar una página desde el menú contextual no funcionaba en Safari

​

Área de pruebas de la API y navigation

• Múltiples códigos de respuesta del área de pruebas de la API ahora se muestran en un menú select con estilo controlado en lugar del menú select predeterminado del sistema cuando está enfocado
• Ahora puedes usar el expanded field on navigation groups in your docs.json to make them be default open

​

SEO y UI

• Se corrigió un error donde los favicons no aparecían en los motores de búsqueda al servirlos desde la misma URL que el sitio de documentación de cada sitio correspondiente
• Se corrigió un error donde las incrustaciones de YouTube parpadeaban al cargar
• Se corrigió un error donde ampliar el menú de comentarios para incluir respuestas escritas causaba cambios de diseño en la tabla de contenido
• Se corrigió un error donde el texto se filtraba por encima de la barra superior en el tema Maple al descartar el banner de notificaciones
• Se mejoraron los temas Maple y Willow añadiendo botones de inicio/cierre de sesión en la barra lateral para un acceso más fácil

​

Analytics y exportaciones

• Se corrigieron problemas de fiabilidad en la vista de analytics del assistant y en las exportaciones
• Las exportaciones de analytics del assistant ahora se ejecutan en segundo plano y se envían por email para una experiencia más confiable

​

Lanzamiento principal: recopilación de comentarios mejorada

• Mejora importante: Los lectores ahora pueden dar comentarios más detallados después de seleccionar pulgar arriba/abajo, incluyendo opciones y comentarios escritos. También puedes recopilar comentarios en bloques de código y ver todas las respuestas en los Analytics de tu dashboard.
  Nota: Contáctanos para habilitar esta función en tu sitio.

​

Mejoras de navegación y de experiencia

• Mejora de experiencia para ignorar barras finales y dobles, de modo que no tengas que preocuparte por escribirlas exactamente en tu docs.json
• Ahora puedes añadir el atributo noAnchor a tus etiquetas HTML h1-6 para evitar que tengan un enlace de ancla
• El tema Palm ahora tiene un selector de idioma flotante en la parte inferior izquierda, similar al enfoque de Stripe
• Se añadió un nuevo campo al docs.json llamado drilldown que te permite controlar si los usuarios se navegan o no a la primera página de un grupo de navegación cuando el grupo se expande
• Mejora de experiencia para que las listas ordenadas anidadas alternen estilos de decimal/romano a alfabético

​

Correcciones de errores y fiabilidad

• Se corrigió un error por el que los enlaces de ancla de la posición de desplazamiento no funcionaban correctamente cuando había componentes JS en una página
• Se corrigió un error por el que Google estaba indexando archivos *.md sin procesar porque les faltaba el encabezado x-robots-tag: noindex
• Se corrigió un error con OAuth en documentación protegida por autenticación, donde no te redirigía a tu página de inicio una vez que completabas el flujo correctamente
• Se corrigió un error en las vistas previas de documentación protegida por autenticación donde no podías ver toda la barra de navegación
• Correcciones en cómo se manejan los SVG con nuestra nueva CDN de imágenes

​

Mejoras de componentes y estilos

• Se añadió un nuevo selector CSS para estilos personalizados en SidebarNavGroupDivider
• Nuevas pruebas de regresión para páginas de API definidas en MDX que tienen seguridad definida garantizarán un mayor grado de estabilidad

​

Mejoras de rendimiento

• Mejora de rendimiento al mover el CSS de KaTeX de cdnjs a nuestra propia CDN en CloudFront para reducir la latencia

​

Mejoras en el manejo de imágenes

• Mejora importante: Las imágenes ya no causan desplazamiento de diseño por defecto, incluso cuando no se especifican los atributos width y height: el dimensionamiento automático evita saltos de contenido durante la carga de la página
• Todos los archivos estáticos de tu repositorio (PDF, TXT, XML, etc.) ahora se suben y sirven automáticamente cuando implementas, proporcionando cobertura completa de recursos

​

Mejoras del editor web e implementación

• Se corrigió el flujo de creación de branch en el editor web para navegar correctamente a, y permanecer en, las ramas recién creadas
• Se mejoró el cuadro de diálogo de conflictos de fusión con una función de escape adecuada; ya no se requieren recargas de página para descartar conflictos
• Se optimizó el rendimiento del flujo de actualización invalidando el caché solo de las páginas cambiadas durante actualizaciones parciales, reduciendo los tiempos de implementación

​

Mejoras de autenticación y navegación

• Nuevo soporte para autenticación en subdirectorios personalizados; si sirves la documentación en https://yourdomain.com/docs, la autenticación ahora funciona sin problemas
• Se corrigió un error de visualización en la barra lateral que se mostraba incorrectamente cuando solo había un enlace configurado
• Renovación integral de la navegación móvil: botones centrados con márgenes/espaciado adecuados, mejor separación en menús desplegables, eliminación de divisores y márgenes innecesarios en secciones vacías, y corrección de problemas de separación/relleno en el tema Maple

​

Correcciones de componentes y estilos

• Se resolvió el problema de conversión de etiquetas <h1-6> que las transformaba incorrectamente en componentes Heading y afectaba el estilo personalizado
• Se añadió un interruptor de configuración del assistant con un clic en el dashboard para una gestión más sencilla

​

Mejoras técnicas y fiabilidad

• Sistema de registro mejorado para los flujos de actualización, lo que permite una depuración más rápida y una resolución de problemas más ágil
• Se corrigió la limitación de tasa de GitHub para clientes con más de 10 especificaciones de OpenAPI/AsyncAPI, cambiando de la obtención de archivos individuales a la clonación del repositorio
• Se mejoró la fiabilidad del assistant con soporte de LLM de respaldo, mejor manejo de errores por límite de tasa y una herramienta de búsqueda más robusta

​

Optimizaciones de rendimiento y de compilación

• La transpilación de MDX ahora ocurre en el momento de la implementación en lugar de en cada carga de página en entornos serverless de NextJS sin caché, lo que mejora el tiempo hasta el primer byte para páginas no cacheadas.
• El hashing basado en contenido evita la retranspilación cuando MDX no ha cambiado, reduciendo los tiempos del flujo de actualización en ~50% para clientes con un gran número de páginas (las implementaciones de más de 5 minutos deberían reducirse aproximadamente a la mitad)
• La visualización de implementaciones de vista previa en el dashboard ahora es más rápida gracias a índices de base de datos adicionales y paralelización de consultas en nuestro backend
• Se redujo el tamaño de la página eliminando datos duplicados de navigation en la carga rsc de cada página; las mejoras de rendimiento son más notorias con un alto número de páginas o estructuras de navegación complejas
• Un prefetch más agresivo permite cargas de página instantáneas con mayor frecuencia

​

Área de pruebas de la API y mejoras de OpenAPI

• La conversión de OpenAPI a MCP se trasladó al backend, lo que permite que los servidores MCP alojados contengan herramientas (pronto habrá documentación y opciones de configuración más claras)
• Se añadió compatibilidad con Ruby al área de pruebas de la API
• Agregamos una función para que ahora puedas especificar páginas de API usando solo tu docs.json sin crear nuevos archivos mdx.
• Compatibilidad con páginas de webhook en la navegación de la documentación a partir de especificaciones OpenAPI
• Se optimizó el contexto del modelo de IA eliminando las especificaciones de enlaces de ancla en enlaces de Markdown al navegar a Anthropic, OpenAI u otros proveedores

​

Mejoras del editor web

• La creación y el cambio de nombre de archivos ahora guardan los cambios al hacer clic fuera, en lugar de requerir presionar la tecla Enter
• Se corrigió la navegación por branch donde cambiar la URL a un branch específico redirigía al último branch activo en lugar del destino previsto
• Codificación correcta de URL para títulos de branch que contienen / a fin de evitar fallos de navegación
• Se corrigió el atajo de enlace Ctrl+K en el Editor del dashboard de monorepo que estaba anteponiendo la ruta del repositorio de documentación y creando enlaces rotos

​

Analytics e integraciones con LLM

• Compatibilidad con llms.txt y llms-full.txt personalizados: agrégalos a la raíz del repositorio de documentación para servirlos en los endpoints /llms.txt y /llms-full.txt para personalización de LLM
• Se añadió la integración de Analytics de Hightouch
• Seguimiento de Analytics del menú contextual mejorado (la visualización en el dashboard llegará pronto)
• Se agregaron pruebas e2e para llms.txt y llms-full.txt para garantizar un servicio correcto

​

Mejoras de componentes y estilos

• Compatibilidad con classnames personalizados en etiquetas h{1-4} para aplicar estilos de encabezado personalizados
• Se corrigió que las etiquetas h{1-4} se renderizaran como componentes Heading con chips en modo de página personalizada
• Se agregaron selectores CSS a breadcrumbs para segmentación personalizada con CSS
• Se corrigieron imágenes open-graph estiradas analizando dimensiones para mantener las proporciones a 56px de height
• Se corrigió VSCode a VS Code en el menú contextual cuando está habilitado
• Se corrigió que los encabezados dentro de componentes personalizados aparecieran en la tabla de contenido junto con encabezados semánticos

​

Corrección de errores y fiabilidad

• Se corrigieron problemas de renderizado de PDF con ciertos títulos de página al sanear caracteres que causaban problemas de generación
• Se resolvió el error de la CLI Cannot convert undefined or null to object al encontrar archivos JSON de OpenAPI vacíos
• Se corrigió que metatags open-graph personalizados en docs.json fueran sobrescritos por los generados
• Se corrigieron los clics del botón de RSS al aterrizar en enlaces de ancla usando origin + pathname para los enlaces RSS
• Se mejoró la velocidad de descarga de la CLI eliminando sourcemaps

​

Mejoras técnicas

• Se agregaron pruebas visuales a la canalización de CI para detectar regresiones antes
• Se mejoró el manejo de errores y las capacidades de depuración
• Cobertura de pruebas integral para nuevas funciones y casos límite

​

Mejoras de autenticación

• Acceso público a nivel de grupo: haz públicos grupos completos de páginas mediante docs.json para no necesitar public: true en cada página (más información)
• Compatibilidad con logoutURL en la configuración de OAuth para eliminar cookies de origen y completar el cierre de sesión
• En caso de errores de OAuth, los usuarios se redirigen a la logoutURL especificada para reiniciar el flujo de autenticación
• Corregido un destello de error 500 durante los flujos de OAuth/JWT antes del callback
• Eliminación automática de https:// de las URL en la configuración de autenticación OAuth/JWT para evitar una configuración incorrecta

​

Mejoras del área de pruebas de la API

• Nuevo endpoint de la Search API para que puedas crear agentes y servidores MCP sobre tu documentación
• Los archivos openapi y asyncapi ahora se sirven en sus rutas especificadas (por ejemplo, https://mydocsurl.extension/{openapi-or-file-name}.json)
• Ahora puedes usar el campo x-mint en tus archivos openapi para sobrescribir campos generados, personalizar el contenido del prefacio o cambiar las URL de los endpoints en ejemplos de código
• x-mcp ahora es x-mint.mcp en configuraciones de OpenAPI para controlar qué rutas se exponen como herramientas MCP

​

Actualizaciones del assistant

• Se corrigió un problema en el que el menú de acciones (con opciones como copiar y pulgar arriba) de los mensajes antiguos desaparecía cuando llegaban nuevos
• Se corrigió la accesibilidad de las páginas anidadas /mcp/... tras el lanzamiento de servidores MCP alojados de la semana pasada

​

Rendimiento y confiabilidad

• Todos los recursos de imagen y video presentes en tu repositorio de documentación ahora se sirven en la ruta adecuada en tu domain. Por ejemplo, si tienes /assets/marketing/my-logo.png en tu repositorio, estará disponible en https://mydocsurl.extension/assets/marketing/my-logo.png.
• El campo de email en el inicio de sesión del Dashboard de Mintlify ahora tiene autofocus para que puedas comenzar a escribir de inmediato (mejora de calidad de vida)
• Tanto dominios personalizados como subdomains en Redis para mejorar el rendimiento de la carga de la navigation (~50 ms de reducción de latencia)
• Se agregó lógica de reintento para exportaciones a PDF para mejorar la confiabilidad
• Se corrigió que el popup de consentimiento de cookies reapareciera después de aceptar o descartar: ahora se respeta la primera selección
• Se corrigió el copiado de una página al portapapeles en Safari especificando un type MIME en navigator.write

​

Mejoras técnicas

• Correcciones de errores de la CLI para Windows y pnpm, además de pruebas de CI para prevenir regresiones
• Salida de registro de errores mejorada: una mejora de calidad de vida para nuestro equipo de ingeniería al depurar
• Correcciones menores a la acción de CI de enlaces rotos cuando faltan archivos contentDirectory
• Se corrigió una regresión causada por las correcciones de la vista previa protegida por autenticación de la semana pasada, donde la Tab activa no se establecía correctamente en la UI de navigation
• Se corrigió que el color de fondo del tema light no se aplicara a los iconos de la Tab activa
• Se corrigió un problema en el que cambiar el tipo de autenticación en el dashboard se actualizaba y luego volvía al tipo guardado previamente: ahora la nueva selección persiste tras guardar
• Mejoras internas de DX para clientes empresariales con bibliotecas de UI personalizadas: ahora nos resulta más fácil incluir tus componentes y atender solicitudes en plazos más cortos

​

Mejoras de autenticación

• Mejoras en el desarrollo local de auth, lo que permite desarrollar más rápido funciones de autenticación y correcciones de errores en esta área del producto
• Las implementaciones de vista previa ahora están disponibles para sitios protegidos con auth
• Se corrigió el comportamiento de redirección para devolver correctamente a los usuarios a su página original después de autenticarse
• Se corrigió la visualización del botón de cerrar sesión para la autenticación completa (antes solo funcionaba con autenticación parcial)

​

Mejoras del área de pruebas de la API

• Se corrigió la carga de archivos multipart/form-data en el área de pruebas de la API
• Se corrigió el comportamiento de los enlaces de anclaje para que, al hacer clic, actualicen la URL sin desplazarse a la parte superior de la página
• Se corrigieron problemas de enlaces de anclaje en pestañas anidadas

​

Actualizaciones del assistant

• Nueva Assistant API para integrarlo en tus propios productos, compatible con el AI SDK
• Se agregó un botón para copiar en las respuestas del chat
• Se corrigió un problema al reintentar mensajes en el assistant
• Mejoras en el prompt predeterminado del assistant para hacerlo menos verboso por defecto

​

Rendimiento y confiabilidad

• La búsqueda se siente más ágil y precisa al abortar solicitudes con debounce mientras escribes
• Aprovisionamiento de recursos para una nueva CDN: se espera que los tiempos de carga de imágenes y páginas mejoren pronto
• Se corrigieron errores al renderizar diagramas complejos de Mermaid como gráficos de Gantt
• Se corrigieron errores de la CLI en Windows para mejorar la estabilidad y se agregaron pruebas para prevenir regresiones

​

Mejoras técnicas

• Se agregó OpenTelemetry para trazas en la aplicación de Next.js para mejorar el time to first byte para los clientes
• Migración de Octokit a GitHub API Client para mejorar la latencia en la experiencia del editor web
• Se corrigieron meta tags duplicadas para OpenGraph
• Se actualizó MongoDB de la versión 6 a la 7 para mejorar el rendimiento y añadir nuevas funciones

​

Slack app

• Acceso sin fricción: el bot responde a DMs, @menciones y cualquier pregunta en tu canal #ask-ai
• Configuración con un clic: instala directamente desde tu Dashboard de Mintlify en segundos
• Respuestas contextuales: busca en toda tu documentación para ofrecer respuestas relevantes y precisas
• Reduce interrupciones de soporte: convierte preguntas diarias en respuestas instantáneas de autoservicio

​

Servidores MCP hospedados

​

Mejoras en el bloque de código

• Resaltado de sintaxis mejorado
• Se agregaron más opciones de personalización, incluyendo modo de enfoque, bloques de código expandibles, adaptación a modo oscuro y claro, menú desplegable de idioma, numeración de líneas e iconos

​

Actualizaciones del Asistente de IA

• Mejora de la precisión mediante RAG agentico con invocación de herramientas
• Proporciona enlaces navegables a las páginas referenciadas para que los usuarios puedan ir directamente a la fuente de las respuestas
• Atajo para copiar ejemplos de código generados por el assistant
• Atajo “Ask AI” en bloques de código de la documentación para generar explicaciones del assistant

​

Cambios suscribibles

• Genera automáticamente un feed RSS a partir de las páginas de cambios
• Integra actualizaciones habilitadas para RSS con Slack, correo electrónico y otras herramientas

​

Actualizaciones de estabilidad del área de pruebas de la API

• Búsqueda para encontrar un endpoint
• Indicar un endpoint en desuso con una etiqueta
• Ocultar páginas de la API generadas automáticamente de la navigation
• Cargar archivos multipart o de datos de formulario

​

mint update

​

Editor web 3.0

• Busca nombres de archivos con el atajo ⌘ + P
• Las páginas cargan 10 veces más rápido
• Cargas más rápidas al buscar una branch
• Pestaña de opciones de página para configurar el diseño, el título y la metadata para SEO
• Barra de herramientas flotante al resaltar texto

• Se corrigió el margen superior de los componentes del changelog
• Mayor fiabilidad del comportamiento del clic derecho
• Después de hacer clic en publicar, te mantendrás en la misma página en lugar de ver un estado vacío
• Colores estandarizados en los iconos de archivos
• Mayor fiabilidad tras seleccionar nuevas branches varias veces seguidas
• Se eliminó el modo Diff
• Más consistencia al crear una carpeta nueva desde el menú desplegable
• Se corrigió que las citas en bloque crearan más citas en bloque al intentar deseleccionar

​

Traducciones con IA en beta

​

Exportar documentación a PDF en beta

​

Compatibilidad con hooks de React

​

Generador de servidor MCP

​

Mejoras

• Etiqueta las actualizaciones del changelog para que los usuarios finales puedan filtrarlas
• Sonnet-3.7 compatible para el chat de IA. Configura tu modelo preferido desde el dashboard
• Cambia el nombre de tu implementación directamente en la configuración del dashboard

​

Correcciones de errores

• Imágenes OG corregidas
• Corregida la inconsistencia de estilo de icon para anclajes sin contenedor
• Pequeñas mejoras de estilo en el borde del dashboard para la adaptación móvil-tablet-escritorio
• Mostrar ejemplos de código incluso en modo simple para el área de pruebas de la API
• Compatibilidad con el atajo “command + k” para buscar en el editor web
• Los bloques de código dentro de los callouts se expanden para ocupar el width del área del callout

​

Nuevo esquema de configuración docs.json

1. Asegúrate de tener la CLI en su última versión

npm i mint@latest -g

1. En tu repositorio de documentación, ejecuta

mint upgrade

1. Elimina tu archivo antiguo mint.json y sube los cambios

​

Comprobaciones de CI

​

Compatibilidad .md para LLM

​

Más temas

• Maple
• Palm
• Willow

​

Otras mejoras

• Guía de redacción técnica: Mejores prácticas para escribir documentación técnica, incluyendo investigación de audiencia, tipos de contenido y consejos de redacción.
• Componente Dropdown: Organiza la navigation con un menú desplegable, además de pestañas y anclas.
• Corrector de sintaxis con IA: El editor web detectará si hay un error de análisis y usará IA para sugerir correcciones.

​

Mejoras del Asistente de IA

• Nueva UI con página de chat dedicada y prompts prellenados
• Mejoras de estabilidad. Por ejemplo, correcciones de errores al editar el archivo equivocado o ninguno
• Conocimiento más sólido para agregar y editar componentes
• Edición mejorada del archivo docs.json

​

Autenticación parcial

​

Área de pruebas de la API renovada

• Expansión de detalles más sencilla para obtener una vista general de un campo
• Diseño anidado más intuitivo. Por ejemplo, agregar o eliminar elementos
• Tiempos de respuesta más rápidos

​

Mejoras de calidad

• Compatibilidad para exigir autenticación para acceder a implementaciones de vista previa

​

Autenticación

​

Redactor con IA

​

Mejora de la integración con GitLab

​

Editor web

​

Compatibilidad con /llms.txt

​

Localización

​

Mejoras de calidad

• Devolver resultados de chat y búsqueda basados en la versión actual que el usuario está leyendo
• Autenticar a los usuarios con OAuth, además de JWT o tokens de sesión compartida.

​

Cambios

​

Resaltado de líneas de código

const greeting = "Hello, World!";
function sayHello() {
  console.log(greeting);
}
sayHello();

```javascript Line Highlighting Example {1,3-5}
const greeting = "Hello, World!";
function sayHello() {
  console.log(greeting);
}
sayHello();
```

​

Bloques de código en modo claro

"codeBlock": {
  "mode": "auto"
}

​

Pie de página avanzado

​

Filtrar la búsqueda según el usuario actual

​

Prompts personalizados para el chat de IA

​

Mejoras del dashboard

• Se agregó la opción de cambiar el dominio personalizado a /docs directamente desde la configuración del dashboard.
• Se unificaron las páginas de inicio de sesión y registro para reducir fricción y confusión.
• Se implementó el flujo de inicio de sesión por descubrimiento para que los usuarios que son miembros de múltiples organizaciones puedan alternar entre ellas.
• Se añadió inicio de sesión con Google OAuth.
• Se añadió la opción de crear una nueva implementación desde la configuración del dashboard.

​

Correcciones de errores

• Ya se pueden usar barras iniciales en navigation.
• Ya se pueden editar archivos CSS y JS en el editor web.
• Se corrigió que suggestEdit no apareciera incluso cuando estaba habilitado.
• Se corrigió la navegación por teclado para Search y Chat, de modo que ahora puedes usar las teclas de flecha arriba y abajo para recorrer los resultados.
• No permitir que los motores de búsqueda rastreen páginas protegidas por autenticación de usuario.
• Revalidar la caché cuando se elimina una organización.
• Ahora usamos el analizador Scalar OpenAPI para interpretar definiciones de OpenAPI, lo que mejora el rendimiento, corrige problemas de análisis y muestra mejores mensajes de error.
• Las descripciones de nivel superior ahora son compatibles en las páginas de referencia de API autogeneradas a partir de definiciones de OpenAPI.
• Agregar compatibilidad con estilo en línea para iconos.
• Se corrigió la aparición repentina del CSS personalizado en la documentación.
• Mostrar correctamente el estilo de código en línea junto con los enlaces.
• Mantener la posición de desplazamiento cuando haces clic en el botón Atrás del navegador.

​

Fuentes personalizadas

​

Imágenes en componentes Card

​

Mejoras en la velocidad de actualización

​

Mejoras de SEO

​

Mejoras del dashboard

• Migración a app router en el dashboard.
• Las analíticas de búsqueda ahora están disponibles en el dashboard.
• Se añadió la funcionalidad para eliminar una organización en el dashboard.
• Se publicó la interfaz de conexión con GitLab.
• Corrección de datos de Analytics incorrectos.
• Los complementos ahora se pueden comprar directamente desde el dashboard.

​

Correcciones de errores

• Se corrigió un error por el que la barra superior no se extendía al width de la pantalla cuando estaba en modo personalizado y el diseño de la barra lateral era sidenav.
• Corrección del posicionamiento relativo del widget de IA.

​

Más

• Solución de problemas para páginas de API: Las páginas de API pueden ser complicadas, así que enumeramos problemas comunes para ayudarte a resolverlos rápidamente — Lee la documentación

​

Páginas de referencia de OpenAPI

• Los endpoints definidos por OpenAPI que son complejos y recursivos ahora son un 98% más pequeños.
• Ahora mostramos additionalProperties en las páginas de OpenAPI.

​

Carga de archivos en el área de pruebas de la API

• Más información sobre configuraciones de API

​

Mejoras de SEO en móviles

​

Formulario de soporte

​

Correcciones de errores

• Se corrigió un error en la funcionalidad de la integración con Segment.
• Ahora mostramos mensajes de error más granulares para permisos de GitHub al interactuar con el editor.
• Se corrigieron errores por los que la navigation no se expandía correctamente cuando se usaba un enlace directo.

​

Widget de IA

• Lee el anuncio en el blog

​

Plan Pro

• Lee el anuncio en el blog

​

Sincronización de ejemplos de código del área de pruebas de la API

​

Insights

​

Lo más destacado de la Launch Week

• Temas: Personaliza el estilo con temas preconfigurados. Solo agrega el tema Quill, Prism o Venus a tu archivo docs.json y se actualizará el estilo de tu documentación.
• Search V2: consulta directamente las descripciones y los títulos de los endpoints de OpenAPI para llegar a las páginas de Referencia de la API, elimina páginas ocultas de la búsqueda y disfruta de nuestra barra de búsqueda actualizada.
• Ramificación en el editor web: crea branches en nuestro editor web sin un IDE.
• Personalización del usuario: autentica a los usuarios con Shared Session o JWT (JSON Web Token) para mostrarles contenido personalizado, como rellenar previamente API keys o mostrar contenido específico para clientes.
• Mejoras de automatización de OpenAPI: para completar automáticamente las páginas del área de pruebas de la API, puedes agregar un campo openapi a un objeto en los arrays tabs o anchors en el docs.json.

​

Okta SSO

​

Mintlify REST API

​

Modo personalizado

• Crea una página de destino global personalizada con componentes personalizados
• Agrega videos a pantalla completa o galerías de imágenes
• Inserta elementos de demostración iFrame personalizados para añadir interactividad a tu documentación

​

Mintlify MDX para VSCode

​

Mejoras de calidad

• Mejoras del dashboard: visualiza registros de actualización para ver qué cambió y el estado de una actualización; alterna entre proyectos de Mintlify para gestionar implementaciones
• Versionado con pestañas totalmente compatible
• Redirecciones wildcard ahora compatibles
• Detección de errores en la CLI: ahora mostramos la posición del frontmatter no válido cuando hay problemas de análisis durante el desarrollo local

​

Lo más destacado de la Launch Week

• Implementaciones de vista previa: cuando creas una solicitud de extracción, generaremos un enlace único que muestra una vista previa en vivo de cómo se ve tu documentación en producción. Puedes compartir este enlace con tus compañeros.
• Snippets V2: ahora admitimos componentes y variables totalmente reutilizables para snippets.
• Motor MDX de código abierto: hemos expuesto dos APIs—getCompiledMdx y MDXComponent—para que puedas acceder al Markdown de Mintlify y al resaltado de sintaxis de código. Las contribuciones al proyecto son bienvenidas.
• Insights de chat con IA: segmenta el historial de chat por fecha, aumenta la cuota de chat con IA desde el dashboard y consulta con qué frecuencia aparece una búsqueda específica.