Las branches son una función del control de versiones que apuntan a confirmaciones específicas en tu repositorio. Tu rama de implementación, generalmente llamada main, representa el contenido que se usa para compilar tu documentación en producción. Todas las demás branches son independientes de tu sitio en producción a menos que decidas fusionarlas en tu rama de implementación.
Las branches te permiten crear instancias separadas de tu documentación para realizar 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 producción hasta que publiques los cambios.
Recomendamos trabajar siempre desde branches al actualizar la documentación para mantener estable tu sitio en producción y habilitar flujos de revisión.
- Pon nombres claros a 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.
- 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 o fix-api-examples.
- Selecciona Create Branch.
Guardar cambios en una 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.
