Skip to main content
Sus cambios se guardan automáticamente mientras edita, pero solo llegan a su sitio publicado cuando los publica. Lo que ocurre al publicar depende de en qué branch trabaja y de si esa branch requiere pull requests.
Si no ve un selector de branch ni un botón Publish, su deployment tiene activada la publicación automática y sus ediciones se publican automáticamente.

Cambios pendientes

El editor registra lo siguiente como cambios pendientes:
  • Ediciones de contenido en páginas
  • Páginas nuevas o eliminadas
  • Cambios en la estructura de navegación
  • Archivos multimedia subidos
  • Actualizaciones de configuración
Si no hay cambios pendientes, el editor deshabilita las acciones de publicar y guardar.

Qué ocurre cuando publica

  • Publish: Hace commit y despliega sus cambios en su sitio publicado de inmediato.
  • Save in branch: Hace commit de sus cambios en la feature branch sin hacer merge en su deployment branch.
  • Create branch: Mueve sus cambios pendientes a una feature branch nueva cuando está en una deployment branch protegida.
  • Create pull request: Abre una pull request dirigida a su deployment branch.
Solo puede realizarse una publicación a la vez por branch. Si un compañero publica en la misma branch, espere a que termine su publicación antes de volver a intentarlo.
Su sitio se actualiza después de que Mintlify compile y despliegue sus cambios. Esto suele tardar entre 30 segundos y unos minutos. Consulte el estado del despliegue en su dashboard.

Cuándo usar una branch

Edite directamente en su deployment branch si no usa un flujo de trabajo basado en Git. Cree una branch si cada cambio pasa por una revisión antes de llegar a su sitio publicado. Para crear una branch, haga clic en el nombre de la branch en la barra de herramientas del editor, seleccione Create new branch, escriba un nombre y haga clic en Create branch.
Crear o cambiar de branch mientras tiene cambios sin publicar le pide que decida si quiere llevarlos consigo o dejarlos atrás. Los cambios que deja atrás permanecen en la branch original.

Resolver conflictos

Los conflictos se producen cuando su branch y la deployment branch tienen cambios incompatibles en los mismos archivos. Por ejemplo, cuando usted y un compañero editan las mismas líneas o mueven un archivo a ubicaciones distintas. Cuando alguien hace push a su repositorio desde fuera del editor, el editor aplica automáticamente los cambios que no se solapan. Si un cambio remoto y su edición afectan a la misma parte de una página, el editor resalta el conflicto. El editor muestra una advertencia cuando los conflictos impiden publicar. Siga las indicaciones para elegir qué versión de cada sección en conflicto quiere conservar.

Firma de commits

Firme los commits con su cuenta de GitHub autorizándola en la configuración de su cuenta. Sin esa autorización, la GitHub App de Mintlify firma los commits hechos en el editor.

Publicación automática

Si su deployment tiene activada la publicación automática, el editor hace commit en su deployment branch poco después de que deje de escribir. El selector de branch y el botón Publish quedan ocultos. No hay estado pendiente ni paso de revisión. Las ediciones en feature branches creadas desde el editor se confirman automáticamente en cualquier caso, pero nunca se publican a menos que haga merge en su deployment branch.