Saltar al contenido principal
La página de configuración del editor controla la apariencia, el comportamiento de publicación y el comportamiento del agente.
  • Appearance: Preferencias personales sobre cómo se ve y se comporta el editor. Se aplican solo a usted.
  • Publishing: Valores predeterminados a nivel de proyecto sobre cómo el editor hace commit de los cambios y abre pull requests. Se aplican a todas las personas que publican. Los admins y editors pueden actualizar el comportamiento de publicación. En los planes Enterprise, solo los admins pueden cambiar Auto publish y Require review before publishing.
  • Chat: Instrucciones persistentes para el agente de IA del editor.
  • Danger zone: Acciones que no se pueden deshacer.

​
Appearance

Los ajustes de apariencia son preferencias personales. Cambian el editor solo para usted y no afectan a sus compañeros de equipo ni a su sitio publicado. Todos los ajustes de apariencia están desactivados de forma predeterminada.
  • Fit editor to full width: Extiende el lienzo de edición de borde a borde en lugar de usar la columna predeterminada de 768px.
  • Show breadcrumbs: Muestra la ubicación de la página en la navegación del sitio encima del lienzo de edición.
  • Open live preview in new tab: Al previsualizar, abre la página representada en una pestaña nueva del navegador.

​
Método de merge de PR

Seleccione cómo hace merge el editor de las pull requests cuando hace clic en Merge and publish:
  • Merge: Crea un commit de merge que conserva el historial completo de la branch. Es la opción predeterminada.
  • Squash: Combina todos los commits de la branch en un único commit en su deployment branch.
  • Rebase: Reaplica cada commit de la branch sobre su deployment branch sin un commit de merge.
Haga coincidir su método de merge con las reglas de protección de branch de su proveedor de Git. Si su deployment branch solo admite squash merges, elija Squash para evitar merges fallidos desde el editor.

​
Publicación automática

La publicación automática hace commit de los cambios en su deployment branch automáticamente, aproximadamente un minuto después de que deje de editar. Si activa este ajuste, el editor oculta las branches y el paso de publicación para todos los usuarios de su sitio. La publicación automática está desactivada de forma predeterminada.
Con la publicación automática activada, no hay estado pendiente ni posibilidad de revisar. Cada edición llega a su sitio publicado poco después de que deje de escribir.
Activar la publicación automática desactiva Requerir revisión antes de publicar.

​
Requerir revisión antes de publicar

Para requerir revisión antes de publicar, debe tener un plan Enterprise y el repositorio de su proyecto debe estar en GitHub.
Cuando requiere revisión antes de publicar, solo los admins pueden publicar cambios directamente en su deployment branch. Todos los demás deben solicitar una revisión, y un revisor debe aprobar los cambios antes de que un admin o publisher pueda publicarlos. Consulte Requerir revisión antes de publicar para ver cómo funcionan las solicitudes y las aprobaciones. Este ajuste está desactivado de forma predeterminada.
  • Solo los admins pueden activar o desactivar este ajuste.
  • Requerir revisiones antes de publicar desactiva la publicación automática.
  • Si su deployment branch tiene protección de branch, su repositorio debe estar en GitHub.com. En ese caso, las revisiones se hacen en branches y los admins no pueden publicar sin revisión. Consulte Revisar con una deployment branch protegida.
  • Las revisiones funcionan en su deployment branch y en las branches que crea en el editor. En una branch, un admin o publisher puede publicar una vez que los revisores aprueban todas las páginas modificadas. Consulte Revisar cambios en una branch.

​
Crear pull requests como borrador de forma predeterminada

Cuando este ajuste está activado, las pull requests creadas desde el editor se abren como borradores, incluida la pull request que se abre tras el primer commit en una branch nueva. Los autores hacen clic en Request review para marcarlas como listas cuando terminan de editar. Este ajuste está activado de forma predeterminada. Si quiere que las pull requests del editor se abran listas para revisión de inmediato, desactive las pull requests en borrador.

​
Agregar coautores a los commits

Cuando esta configuración está activada, cada commit que realiza el editor incluye como coautor a la persona que hace el cambio. Los proveedores de Git como GitHub atribuyen entonces el commit a la persona que hace el cambio y al bot de Mintlify como coautores. Esta configuración está desactivada de forma predeterminada. Si conecta su cuenta de GitHub a Mintlify, la atribución de coautor usa su dirección de correo electrónico no-reply de GitHub. De lo contrario, usa la dirección de correo electrónico de su cuenta de Mintlify.

​
Mostrar los cambios de los compañeros

Show teammates’ changes controla si el menú Publish enumera los cambios pendientes de sus compañeros en su deployment branch.
Este ajuste se llamaba anteriormente Granular publishing.
  • Desactivado (predeterminado): El menú Publish enumera solo sus propios cambios. Seleccione cuáles de ellos publicar. Los cambios hechos solo por sus compañeros no aparecen.
  • Activado: El menú Publish también enumera los cambios pendientes de sus compañeros, divididos en Your changes y Modified by others, para que también pueda publicarlos.
Este ajuste solo tiene efecto mientras trabaja en su deployment branch y esa branch no tiene protecciones de branch. Consulte Publicar cambios concretos para más información.

​
Mostrar todas las branches

Mostrar todas las branches controla qué branches enumera el menú de branches antes de que busque.
  • Desactivado (predeterminado): El menú de branches enumera su deployment branch, las branches creadas en el editor y las branches con pull requests abiertas o en borrador. Las branches fusionadas o cerradas y otras branches de su repositorio solo aparecen cuando las busca por nombre.
  • Activado: El menú de branches enumera todas las branches, incluidas las creadas fuera del editor y las fusionadas o cerradas.
Consulte Gestionar branches para más información.

​
Instrucciones de IA

Las instrucciones de IA son directrices persistentes que el editor envía a la IA junto con su solicitud. Úselas para recoger reglas de estilo y tono que no quiere repetir cada vez, como la voz, la terminología o las convenciones de formato. Sus instrucciones se aplican a:
  • Las sesiones del agente iniciadas desde el editor.
  • Las respuestas de @mintlify en los hilos de comentarios.
Cada compañero mantiene sus propias instrucciones, vinculadas a su cuenta de usuario. Las instrucciones tienen un límite de 20.000 caracteres. Añada instrucciones de IA cuando se dé cuenta de que repite las mismas directrices en los prompts, por ejemplo:
  • Exigir la segunda persona o títulos en formato de frase.
  • Preferir nombres de producto o terminología concretos.
  • Prohibir el lenguaje de marketing o las frases de relleno.
  • Exigir determinados componentes, como usar siempre <Note> para las llamadas de atención.
Mantenga las instrucciones breves y concretas. La IA las sigue en cada solicitud, así que las reglas vagas o contradictorias empeoran los resultados. Ejemplo:
Deje el campo vacío para eliminar sus instrucciones.

​
Restablecer editor

Reset editor obliga al editor a descartar su estado local y sincronizarse con su repositorio de Git. Después de confirmar, el editor se recarga. Los admins y editors pueden restablecer el editor. Restablezca el editor si se queda desincronizado con su repositorio, por ejemplo si el árbol de archivos está vacío o muestra errores como Unable to find docs.json. Esto puede ocurrir aunque el archivo exista en su deployment branch y su sitio se compile con normalidad.
Si restablece el editor, descarta cualquier cambio sin publicar que no haya confirmado en Git. Si tiene ediciones pendientes que quiere conservar, publíquelas primero.