Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://mintlify-mintlify-ac127224.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

El editor expone dos grupos de ajustes:
  • Configuración de usuario se aplica solo a ti y te acompaña en todos los deployments.
  • Configuración de publicación se aplica a todo el deployment y afecta a todos los editores del equipo.

​
Configuración de usuario

La configuración de usuario es personal. Los cambios que realices solo afectan a tu editor y no modifican nada para tus compañeros.

​
Preferencias

Controla cómo se ve y se comporta el editor para ti.
  • Estructura de navegación: Cómo se listan tus páginas en la barra lateral izquierda.
    • file-tree (predeterminado): Muestra las páginas como un árbol de archivos que refleja tu repositorio.
    • docs-nav: Muestra las páginas en el orden definido por la navegación de tu docs.json.
  • Ajustar a ancho completo: Cuando está activado, el contenido se expande para ocupar todo el ancho del editor en lugar de usar el ancho de lectura predeterminado. Útil en monitores anchos.
  • Abrir la vista previa en una nueva pestaña: Cuando está activado, al hacer clic en el botón de vista previa en vivo se abre la vista previa en una nueva pestaña del navegador en lugar de en el panel lateral.

​
Instrucciones de IA

Añade instrucciones personales que las funciones de IA del editor utilizarán al generar o editar contenido para ti. Úsalas para definir tu tono, vocabulario o reglas de estilo preferidos. Las instrucciones de IA están limitadas a 20.000 caracteres.
Mantén las instrucciones de IA breves y específicas. Por ejemplo: “Usa mayúsculas tipo oración en los encabezados. Evita la palabra ‘simplemente’. Prefiere la voz activa.”

​
Configuración de publicación

La configuración de publicación se aplica a todo tu deployment. Cualquier persona con permiso para actualizar el deployment puede modificarla, y los valores se utilizan en cada pull request creado desde el editor.
  • Instrucciones para commits: Pautas que el editor sigue al generar mensajes de commit. Úsalas para imponer un formato de mensaje de commit como Conventional Commits. Limitado a 20.000 caracteres.
  • Instrucciones para PR: Pautas que el editor sigue al generar títulos y descripciones de pull requests. Úsalas para exigir una plantilla de PR específica o una lista de verificación. Limitado a 20.000 caracteres.
  • Crear PR como borrador por defecto: Cuando está activado, el editor abre los nuevos pull requests como borradores. Actívalo si tu equipo revisa los cambios en borrador antes de solicitar revisión.
  • Método de combinación de PR: Cómo combina el editor los pull requests.
    • merge (predeterminado): Crea un commit de merge.
    • squash: Combina todos los commits en uno solo.
    • rebase: Reaplica los commits sobre la rama de destino sin un commit de merge.
El método de combinación de PR solo se aplica a las combinaciones iniciadas desde el editor. Las combinaciones realizadas directamente en tu proveedor de Git usan la configuración de ese proveedor.

​
Ejemplo: aplicar Conventional Commits

Define instrucciones de commit como las siguientes para que el editor formatee cada mensaje de commit de forma coherente:
Instrucciones para commits
Usa el formato Conventional Commits: <type>(<scope>): <subject>.
Tipos: feat, fix, docs, chore, refactor.
Mantén el asunto por debajo de 70 caracteres y usa el modo imperativo.