Saltar al contenido principal

Flujos de publicación

El editor admite dos flujos de trabajo para publicar actualizaciones de la documentación. El flujo que uses depende de las reglas de protección de branch de tu repositorio y de la branch en la que trabajes.
  • Crear solicitudes de extracción: Si tu repositorio tiene una regla de protección de branch que requiere solicitudes de extracción antes de que los cambios se puedan fusionar en tu rama de implementación, el editor crea una solicitud de extracción cuando publicas cambios.
  • Publicar directamente: Si tu repositorio no tiene reglas de protección de branch, tus cambios se fusionan en la rama de implementación y se implementan de inmediato cuando publicas.
Tipo de branchProtección de branchFlujo de publicación
NingunaRealiza una confirmación e implementa los cambios
Rama de implementaciónSolicitudes de extracción obligatoriasCrea una solicitud de extracción
NingunaFusiona los cambios en la rama de implementación e implementa los cambios
Branch de funcionalidadSolicitudes de extracción obligatoriasCrea una solicitud de extracción
Configura reglas de protección de branch en tu proveedor de Git para requerir solicitudes de extracción. Consulta Acerca de las ramas protegidas en la documentación de GitHub o Ramas protegidas en la documentación de GitLab.

Guardar cambios

A medida que editas, el editor realiza un seguimiento de tus cambios.
  • Archivos nuevos o eliminados.
  • Ediciones de contenido en las páginas.
  • Cambios en la estructura de navegación.
  • Cargas y organización de archivos multimedia.
  • Actualizaciones de configuración.
Cuando trabajas en tu rama de implementación, los cambios se guardan automáticamente.
Barra de herramientas del editor web que muestra un cambio pendiente.

Cambios en una rama de implementación.

Cuando trabajas en una rama de funcionalidad, puedes guardar los cambios en la rama como .
Barra de herramientas del editor web que muestra un cambio pendiente y el botón Save as commit en una rama de funcionalidad.

Cambios en una rama de funcionalidad.

Para descartar cambios, haz clic en Undo changes junto al nombre de un archivo en el menú desplegable Changes.

Publica tus cambios

Si estás en una rama de implementación, haz clic en Publish en la barra de herramientas. Según tu flujo de trabajo, tus cambios estarán visibles en el sitio en cuanto se vuelva a implementar o cuando crees una solicitud de extracción y la fusiones en tu proveedor de Git. Si estás en una rama de funcionalidad, guarda tus cambios y luego haz clic en Publish en la barra de herramientas. Según tu flujo de trabajo, tus cambios estarán visibles en el sitio en cuanto se vuelva a implementar o cuando crees una solicitud de extracción y la fusiones en tu proveedor de Git.

Resolver conflictos

Los conflictos se producen cuando tu branch y la rama de implementación contienen cambios incompatibles en los mismos archivos.

Qué provoca los conflictos

Los conflictos se producen cuando:
  • Tú y otra persona del equipo modifican las mismas líneas de un archivo.
  • Los archivos se mueven o eliminan en una branch, pero se modifican en otra.

Resolver conflictos

El editor muestra advertencias cuando los conflictos impiden realizar operaciones como publicar o cambiar de branch. Para resolverlos, sigue las instrucciones del editor para elegir qué cambios conservar.

Firma de confirmaciones

Firma tus confirmaciones con tu cuenta de GitHub al autorizarla en la configuración de la cuenta. Sin autorización, la Aplicación de GitHub de Mintlify firma las confirmaciones realizadas en el editor web. Asociar las confirmaciones a tu cuenta mantiene un historial preciso de quién hizo cambios en tu documentación.