Changelog
Actualizaciones de estabilidad del área de pruebas de API
- Búsqueda para encontrar un endpoint
- Indicar un endpoint obsoleto con una etiqueta
- Ocultar páginas de API generadas automáticamente de la navegación
- Subir archivos multipart o de datos de formulario
Aprende más en documentación del área de pruebas de API.
npm i mint
Ahora puedes usar npm i mint@latest -g
para actualizar tu CLI.
Editor Web 3.0
Usabilidad renovada en el editor WYSIWYG.
Mejoras importantes
- Buscar nombres de archivos usando el atajo ⌘ + P
- Las páginas cargan 10 veces más rápido
- Tiempos de carga más rápidos al buscar una rama
- Pestaña de opciones de página para configurar diseño, título y metadatos para SEO
- Barra de herramientas flotante al resaltar texto
Correcciones adicionales
- Margen superior fijo para componentes de registro de cambios
- Mejorada la fiabilidad del comportamiento del clic derecho
- Después de hacer clic en publicar, permanecerás en la misma página en lugar de ser llevado a un estado vacío
- Colores estandarizados en los iconos de archivos
- Mejorada la fiabilidad después de seleccionar nuevas ramas varias veces seguidas
- Eliminado el modo Diff
- Mayor consistencia al crear una nueva carpeta desde el menú desplegable
- Corregido el problema de las citas en bloque que creaban más citas en bloque al intentar deseleccionar
Traducciones con IA en beta
Traduce toda tu documentación con IA. Aprende más.
Exportación de documentos a PDF en beta
Exporta toda tu documentación, un subdirectorio o una sola página como PDF.
Soporte para hooks de React
Añade interactividad a tus documentos. Todos los hooks estándar de React están automáticamente disponibles en tus archivos MDX. Aprende más.
Generador de servidor MCP
Genera servidores MCP para que las aplicaciones de IA puedan interactuar con tus documentos o APIs. El contenido escrito se genera automáticamente como un servidor MCP, y puedes generar un servidor MCP a partir de tu especificación OpenAPI con un solo clic. Consulta la documentación sobre cómo empezar con MCP.
Mejoras
- Etiquetar actualizaciones del registro de cambios para que los usuarios finales puedan filtrar las actualizaciones
- Sonnet-3.7 compatible con AI Chat. Configura tu modelo preferido a través del panel de control
- Cambia el nombre de tu despliegue directamente en la configuración del panel de control
Correcciones de errores
- Imágenes OG corregidas
- Corregida la inconsistencia de estilo de los iconos para anclajes sin contenedor
- Mejorados los detalles de estilo del borde del panel de control para la capacidad de respuesta móvil-tableta-escritorio
- Mostrar ejemplos de código incluso en modo simple para el área de pruebas de API
- Soporte para el atajo “command + k” para búsqueda en el editor web
- Los bloques de código dentro de las notas se expanden para llenar el ancho del área de la nota
Nuevo esquema de configuración docs.json
Hemos introducido un nuevo docs.json
esquema como reemplazo de mint.json
, para admitir mejor el control de versiones multinivel, una comprensión visual más fácil y una terminología más consistente. Para obtener más información sobre lo que ha cambiado, consulta nuestro blog.
Actualiza de mint.json
a docs.json
con los siguientes pasos:
- Asegúrate de que tu CLI esté en la última versión
- En el repositorio de tus documentos, ejecuta
- Elimina tu antiguo archivo mint.json y sube tus cambios
Comprobaciones de CI
Revisa automáticamente tus documentos para encontrar enlaces rotos, descubrir problemas de ortografía y gramática, o aplicar estilos de escritura con tu propia configuración de Vale. Aprende más en nuestra documentación.
Soporte .md para LLMs
Todas las páginas de documentación están ahora automáticamente disponibles como archivos Markdown simples—solo añade .md
a la URL. Esto facilita que los LLMs ingieran páginas individuales de tu documentación.
Más Temas
Nuevos temas preconfigurados para modificar el aspecto y la sensación de tus documentos. Configura a través de tu archivo docs.json.
Ahora disponibles:
- Maple
- Palm
- Willow
Otras mejoras
- Guía para la Escritura Técnica:Mejores prácticas para escribir documentación técnica, incluyendo investigación de audiencia, tipos de contenido y consejos de escritura.
- Componente desplegable: Organiza la navegación con un menú desplegable, además de pestañas y anclajes.
- 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 interfaz de usuario con página de chat dedicada y prompts preestablecidos
- Mejoras de estabilidad, por ejemplo, correcciones de errores al editar el archivo incorrecto o ningún archivo en absoluto
- Conocimiento más robusto para añadir y editar componentes
- Edición mejorada del archivo mint.json
Autenticación Parcial
Personaliza el acceso a cualquier página o sección de contenido según los permisos del usuario. Compatible con la conexión a tu propio sistema de autenticación.
Área de pruebas de API renovada
Hemos renovado completamente el diseño y el rendimiento del Área de pruebas de API. Las actualizaciones incluyen:
- Expansión más fácil de detalles para una visión general de un campo
- Diseño anidado más intuitivo, por ejemplo, para añadir o eliminar elementos
- Tiempos de respuesta más rápidos
Mejoras de Calidad
- Soporte para requerir autenticación para acceder a despliegues de vista previa
Autenticación
Haz que los documentos sean privados configurando la autenticación mediante JWT, OAuth o una contraseña universal. Con esta privacidad, puedes crear una base de conocimientos interna o evitar que los competidores vean tus documentos.
Asistente de IA
Ahora puedes pedirle a la IA que haga cambios en tus documentos, con el contexto de toda la documentación existente. Escribe un prompt y el asistente propondrá cambios generando una solicitud de extracción.
Actualización de la Integración con GitLab
Hemos mejorado nuestro soporte para la sincronización con GitLab, como habilitar actualizaciones automatizadas y despliegues de vista previa. Consulta nuestra documentación sobre GitLab para comenzar.
Editor Web
Hemos renovado nuestro editor web para que ahora puedas actualizar los documentos con una experiencia completamente WYSIWYG, mientras se sincroniza con markdown.
Echa un vistazo a nuestros documentos sobre cómo empezar con el Editor Web.
/llms.txt support
Todas las instancias de documentos ahora se alojan automáticamente en /llms.txt y /llms-full.txt para que los LLMs puedan ingerir fácilmente tu documentación. Para más información, lee los documentos sobre el nuevo estándar llms.txt.
Localización
Ahora puedes localizar tus documentos, lo que funciona de manera similar al versionado. Añade un locale
a una versión y el contenido fijo en Mintlify como “¿Fue útil esta página?” también coincidirá con el idioma.
Mejoras de Calidad
- Devuelve resultados de chat y búsqueda basados en la versión actual que el usuario está leyendo
- Autentica usuarios con OAuth, además de tokens JWT o de Sesión Compartida.
Registros de cambios
Lanzamos un nuevo componente Update para facilitar la visualización y el informe de actualizaciones (como esta) a tus usuarios.
Resaltado de Líneas de Código
Ahora puedes resaltar líneas de código en tus documentos para enfatizar y llamar la atención sobre partes importantes añadiendo un comentario especial después del identificador del lenguaje. Usa llaves {}
y especifica números de línea o rangos separados por comas.
Bloques de código en modo claro
Los bloques de código ahora tienen una variante en modo claro que se puede habilitar añadiendo lo siguiente a tu mint.json
:
Pie de Página Avanzado
Ahora puedes añadir más enlaces al pie de página estándar. Esta mejora proporciona más consistencia entre las páginas de inicio y los documentos, o una mayor personalización si deseas destacar páginas específicas como redes sociales o registros de estado.
Filtrar búsqueda basada en el usuario actual
Cuando la personalización está habilitada, los resultados de búsqueda ahora se filtran según el usuario actualmente conectado para que solo vean el contenido relevante.
Indicaciones Personalizadas para el Chat de IA
Ahora puedes personalizar las indicaciones para el chat de IA. Por favor, contacta con el soporte si deseas personalizar las indicaciones.
Mejoras en el Panel de Control
- Se añadió la capacidad de cambiar el dominio personalizado a /docs directamente a través de la configuración del panel de control.
- Se consolidaron las páginas de inicio de sesión y registro para disminuir la fricción y la confusión.
- Se implementó el flujo de inicio de sesión de descubrimiento para que los usuarios que son miembros de múltiples organizaciones ahora puedan cambiar entre ellas.
- Se añadió el inicio de sesión con OAuth de Google
- Se añadió la capacidad de agregar nuevos despliegues a través de la configuración del panel de control.
Correcciones de Errores
- Ahora se pueden usar barras diagonales iniciales en la navegación.
- Ahora se pueden editar archivos CSS y JS en el editor web.
- Se corrigió
suggestEdit
que no aparecía incluso cuando estaba habilitado. - Se corrigió la navegación por teclado para Búsqueda y Chat de modo que ahora puedes usar las teclas de flecha arriba y abajo para navegar por los resultados.
- No se permite a los motores de búsqueda rastrear páginas protegidas por autenticación de usuario.
- Se revalida la caché cuando se elimina una organización.
- Ahora usamos el analizador Scalar OpenAPI para analizar definiciones OpenAPI, lo que mejora el rendimiento, corrige problemas de análisis y muestra mejores mensajes de error.
- Ahora se admiten descripciones de nivel superior en las páginas de referencia de API generadas automáticamente a partir de definiciones OpenAPI.
- Se añadió soporte de estilo en línea para iconos
- Se corrigió la aparición repentina de CSS personalizado en los documentos.
- Se muestra correctamente el estilo de código en línea junto con los enlaces.
- Se mantiene la posición de desplazamiento cuando haces clic en el botón de retroceso en un navegador.
Fuentes Personalizadas
Personaliza la fuente de tus documentos con tu propia fuente alojada en un CDN o eligiendo entre las fuentes de Google para que tus documentos coincidan con tu marca.
Imágenes en componentes de Tarjeta
Añade una propiedad img
a una tarjeta para mostrar una imagen en la parte superior de la tarjeta. Aprende más sobre esto aquí.
Mejoras en la Velocidad de Actualización
Para proyectos grandes (~3,000 archivos), el paso de descarga para actualizaciones de documentos es ahora ~440 veces más rápido - una reducción del 99.8% en tiempo. En general, las descargas de archivos durante las actualizaciones son ahora ~5.5 veces más rápidas - una reducción del 81.8% en tiempo.
Mejoras de SEO
Hemos corregido tanto el diseño móvil como el de escritorio de nuestros documentos para que sean más amigables con el SEO - incluyendo la adición de etiquetas aria adecuadas a los elementos de la barra de navegación y de alternancia.
Mejoras en el Panel de Control
- Migración del enrutador de aplicaciones en el panel de control.
- Las analíticas de búsqueda ahora están disponibles en el panel de control.
- Se ha añadido la funcionalidad de eliminar una organización al panel de control.
- Se implementó la interfaz de usuario de conexión con GitLab.
- Se corrigieron datos de analíticas incorrectos.
- Los complementos ahora se pueden comprar directamente a través del panel de control.
Correcciones de Errores
- Se corrigió un error donde la barra superior no se extendía al ancho de la pantalla cuando estaba en modo personalizado y el diseño de la barra lateral era
sidenav
. - Se corrigió el 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 hemos listado problemas comunes para ayudarte a resolverlos rápidamente —Lee los documentos
Páginas de Referencia OpenAPI
- Los endpoints definidos por OpenAPI que son complejos y recursivos son ahora un 98% más pequeños.
- Ahora mostramosadditionalPropertiesen las páginas de OpenAPI.
Carga de Archivos en el Área de Juegos de API
Por defecto, las solicitudes del área de juegos de API son proxificadas por Mintlify. Ahora puedes usardisableProxy
para deshabilitar este comportamiento y admitir tipos de solicitudes como cargas de archivos.
Mejoras de SEO para móviles
Hemos corregido el diseño móvil de nuestros documentos para que sean más amigables con el SEO - incluyendo la adición de etiquetas aria adecuadas a los elementos.
Formulario de Soporte
Hemos añadido un formulario de soporte más detallado al panel de control de Mintlify. Ahora puedes enviar un formulario para ponerte en contacto con nosotros.
Correcciones de Errores
- Se corrigió un error en la funcionalidad de integración de Segment.
- Ahora mostramos mensajes de error más detallados para los permisos de GitHub al interactuar con el editor.
- Se corrigieron errores donde la navegación no se expandía correctamente cuando se usaba un enlace directo.
Widget de IA
Para Pro
usuarios, presentamos Mintlify Widget, una extensión de su documentación para responder a las preguntas de sus usuarios cuando y donde las hagan. Puede agregar este chatbot impulsado por IA a cualquier página web: su página de inicio, dentro de su producto o en sus páginas de documentación existentes.
Pro Plan
También actualizamos nuestros planes de precios para una mejor personalización y escala.
Sincronización de ejemplos de código del API Playground
Cuando navega por la documentación de la API, el ejemplo de código seleccionado ahora se sincroniza a través de sus páginas.
Insights
Actualmente en beta, esta función resume las preguntas y patrones comunes de los usuarios en informes fáciles de digerir con sugerencias impulsadas por IA sobre cómo mejorar su producto.
Aspectos destacados de la Semana de Lanzamiento
- Themes: Customize your styling with pre-configured themes. Just add the theme Quill, Prism, or Venus to your
mint.json
archivo y actualizará el estilo de su documentación. - Búsqueda V2: consulte directamente las descripciones y títulos de los endpoints de OpenAPI para llegar a las páginas de Referencia de API, elimine las páginas ocultas de la búsqueda y disfrute de nuestra interfaz de barra de búsqueda actualizada.
- Ramificación del editor web: cree ramas en nuestro editor web sin un IDE.
- Personalización de usuario: autentique a los usuarios con Shared Session o JWT para que pueda mostrarles contenido personalizado, como prellenar claves de API o mostrar contenido específico para los clientes.
- Mejoras de automatización de OpenAPI: para autocompletar las páginas de API Playground, puede agregar un
openapi
campo a un objeto en los arrays de tabs o anchors en el mint.json.
Modo personalizado
Agregue una configuración a los metadatos para eliminar todos los elementos excepto la barra superior. Casos de uso de ejemplo:
- Cree una configuración de página de inicio global personalizada con componentes personalizados
- Agregue videos de pantalla completa o galerías de imágenes
- Incruste elementos de demostración de iFrame personalizados para agregar interactividad a su documentación
Consulte nuestra documentación del Modo Personalizado.
Mintlify MDX para VSCode
Llame a fragmentos de nuestros componentes y llamadas preconfiguradas sin salir de VSCode. Instale la extensión aquí.
Mejoras de calidad
- Mejoras en el panel de control: vea los registros de actualización para ver qué ha cambiado y el estado de una actualización, alterne entre proyectos de Mintlify para gestionar implementaciones
- Versionado con pestañas totalmente compatible
- Redirecciones con comodines ahora compatibles
- Detección de errores de CLI: ahora mostramos la posición del frontmatter inválido cuando hay problemas de análisis durante el desarrollo local
Aspectos destacados de la Semana de Lanzamiento
- Implementaciones de vista previa: Cuando cree una solicitud de extracción, generaremos un enlace único que muestra una vista previa en vivo de cómo se verá su documentación en producción. Puede compartir este enlace con los miembros del equipo.
- Snippets V2: Ahora admitimos componentes completamente reutilizables y variables para snippets.
- Motor MDX de código abierto: Hemos expuesto dos APIs—getCompiledMdx y MDXComponent—para que pueda acceder al markdown de Mintlify y al resaltado de sintaxis de código. Las contribuciones al proyecto son bienvenidas.
- Insights del Chat de IA: Segmente el historial de chat por fecha y aumente la cuota del Chat de IA desde el panel de control, y vea con qué frecuencia aparece una consulta específica.