Skip to main content
Trabaje con su equipo en una página comentándola, sugiriendo cambios o editándola conjuntamente al mismo tiempo.

Comentarios

Los comentarios le permiten dejar opiniones sobre un texto concreto sin editar el contenido. Los comentarios nunca llegan a su repositorio. Existen solo dentro del editor y nunca se incluyen en el sitio publicado ni se confirman en Git. Para añadir un comentario, resalte un texto y haga clic en el icono Comment de la barra de herramientas. Para responder, haga clic en el texto resaltado o en el hilo de la barra lateral de comentarios.
El botón de comentario en la barra de herramientas flotante sobre el texto seleccionado en el editor.
Todos los roles pueden comentar y responder, incluidos los viewers. Solo los editors y admins pueden resolver hilos. Resolver un hilo lo quita de la barra lateral y elimina el resaltado de la página. Puede eliminar sus propios comentarios y los admins pueden eliminar cualquier comentario. Eliminar el primer comentario de un hilo elimina el hilo completo. Escriba @ para mencionar a un compañero. Debe ser miembro de su organización y recibirá una notificación por correo electrónico. Si su branch tiene una pull request abierta, Mintlify añade a su descripción un resumen de los hilos sin resolver, con un enlace a cada comentario. El resumen se actualiza a medida que cambian los hilos.

Sugerencias

Las sugerencias proponen un cambio manteniendo el contenido actual, de modo que un compañero pueda aceptarlas o rechazarlas. Los editors y admins pueden aceptar o rechazar cualquier sugerencia. Los viewers no. Para hacer una sugerencia, resalte un texto y haga clic en el botón Switch to Suggesting de la barra de herramientas. En el modo de sugerencias, sus eliminaciones e inserciones aparecen como texto resaltado en lugar de como ediciones. Las sugerencias pendientes aparecen en la barra lateral junto a los comentarios.
Los viewers están siempre en modo de sugerencias. El modo de sugerencias se activa automáticamente cuando un viewer abre el editor, de forma que pueda proponer cambios sin editar el contenido directamente.
Haga clic en una sugerencia resaltada para aceptarla o rechazarla. Cualquiera de las dos opciones resuelve y elimina el hilo de la sugerencia. Un cambio aceptado pasa a formar parte de su branch actual y se publica la próxima vez que publique.

Preguntar al agente de Mintlify

Mencione @mintlify en un comentario, una sugerencia o una respuesta para preguntar al agente del editor sobre la página actual. El agente se ejecuta en segundo plano con la página, el hilo y la branch como contexto, y luego publica su respuesta en el mismo hilo.
El agente funciona en modo de solo lectura cuando responde a comentarios. Puede buscar en su documentación, leer páginas, consultar contenido web y cargar skills, pero no puede editar contenido, crear sugerencias ni publicar. Para hacer cambios, abra directamente el agente del editor. Las menciones funcionan en páginas privadas para los miembros que ya tienen acceso. Cada respuesta cuenta para su uso del agente del editor.

Edición en tiempo real

Cuando varias personas abren la misma página en la misma branch, editan conjuntamente. El cursor y las ediciones de cada persona son visibles para todos, con avatares en la barra de herramientas.
  • Los cambios de todos los colaboradores se combinan automáticamente. Que dos personas editen la misma sección no genera conflictos.
  • Deshacer solo afecta a sus propias ediciones.
  • Si pierde la conexión, sus ediciones se guardan localmente y se sincronizan cuando vuelve a conectarse.
Cuando el agente de Mintlify edita una página a través de la API o de MCP, aparece como cualquier otro colaborador, con un avatar y un cursor en vivo en su edición más reciente. El cursor desaparece cuando el agente termina.