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. Si tu repositorio tiene reglas de protección de branch que requieren revisión, el editor crea una solicitud de extracción. Los miembros del equipo pueden revisar tus cambios antes de que se publiquen. Para flujos de colaboración y procesos de revisión en equipo, consulta Colaborar. Si no hay reglas de protección, tus cambios se fusionan en la rama de implementación y se implementan de inmediato.
Tipo de branchProtección de branchQué ocurre cuando publicas
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
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.
Barra de herramientas del editor web que muestra un cambio pendiente.
Cuando trabajas en tu rama de implementación, los cambios se guardan automáticamente. 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.
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.