Colaborar en el editor

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

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 hacen commit en Git. 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.

Para añadir un comentario, resalte un texto y haga clic en el icono Comment de la barra de herramientas o presione Cmd + Shift + M (macOS) o Ctrl + Shift + M (Windows).

Escriba @ para mencionar a un compañero en un comentario. Debe ser miembro de su organización y haber aceptado su invitación. Cuando menciona a un compañero en un comentario, recibe una notificación por correo electrónico. Gestione qué correos de comentarios y sugerencias recibe desde la página de Notificaciones de su dashboard.

Los hilos de comentarios aparecen tanto en el modo visual como en el modo source. En el modo source puede leer, responder y resolver hilos existentes, pero para iniciar un comentario nuevo necesita el modo visual.

Para ver todos los hilos de la página actual:

1. Haga clic en More options en la esquina superior derecha de la página.
2. Haga clic en Comments.

Reaccione a un comentario para darse por enterado sin responder. Pase el cursor sobre un comentario, haga clic en el botón Add reaction y elija un emoji. Reaccionar al comentario de otra persona envía una notificación al autor del comentario.

Para editar o eliminar un comentario que ha escrito, haga clic en More actions en el comentario. Solo puede editar y eliminar sus propios comentarios. Eliminar el primer comentario de un hilo elimina el hilo completo.

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 Switch to suggesting en la barra de herramientas o presione Cmd + Shift + E (macOS) o Ctrl + Shift + E (Windows). En el modo de sugerencias aparece una etiqueta Suggesting en la barra superior, y sus eliminaciones e inserciones aparecen como texto resaltado en lugar de como ediciones. Haga clic en la etiqueta para volver a editar. Las sugerencias pendientes aparecen junto a la página y en el panel de comentarios.

Haga clic en una sugerencia resaltada y luego en Accept suggestion o Reject suggestion. Cualquiera de las dos opciones resuelve 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.

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.

@mintlify does this endpoint support pagination?
@mintlify are there any pages that contradict this?

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.

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.

La edición en tiempo real funciona tanto en el modo visual como en el modo source. Puede editar el MDX en el modo source mientras un compañero trabaja en el modo visual sobre la misma página. Su cursor y su selección aparecen en su editor, y los suyos aparecen en el de él, incluidos los campos de título y descripción.

• 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.
• En el modo source, el MDX no válido o el YAML de frontmatter no válido permanecen locales hasta que los corrige. Sus compañeros solo reciben contenido válido, y el MDX no válido bloquea la publicación hasta que se repara.

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.