main
, representa el contenido que se utiliza para compilar tu documentación en vivo. Todas las demás branches son independientes de tu documentación en vivo a menos que decidas fusionarlas con tu rama de implementación.
Las branches te permiten crear instancias separadas de tu documentación para hacer cambios, obtener revisiones y probar nuevos enfoques antes de publicar. Tu equipo puede trabajar en branches para actualizar diferentes partes de tu documentación al mismo tiempo sin afectar lo que los usuarios ven en tu sitio en vivo hasta que publiques cualquier cambio.
Recomendamos trabajar siempre desde branches al actualizar la documentación para mantener estable tu sitio en vivo y habilitar flujos de trabajo de revisión.
- Nombra claramente las branches para que tu equipo entienda en qué estás trabajando.
- Elimina las branches después de fusionarlas para mantener tu repositorio organizado.
- Informa a tu equipo cuando estés trabajando en cambios importantes que puedan afectar su trabajo.
Crear una branch
- Selecciona el nombre de la branch en la barra de herramientas del editor (generalmente
main
de forma predeterminada). - Selecciona New Branch.
- Ingresa un nombre descriptivo para tu branch, como
update-getting-started
ofix-api-examples
. - Selecciona Create Branch.
Guardar cambios en una branch
Cambiar de branch
- Selecciona el nombre de la branch en la barra de herramientas del editor.
- Selecciona la branch a la que quieres cambiar en el menú desplegable.
Los cambios no guardados se perderán al cambiar de branch. Asegúrate de guardar o publicar tu trabajo antes de cambiar de branch.