Las ramas son una característica del control de versiones que apuntan a commits específicos en tu repositorio. Tu rama de despliegue, normalmente llamada main, representa el contenido que se usa para compilar tu documentación en producción. Todas las demás ramas son independientes de tu documentación publicada, salvo que decidas fusionarlas en tu rama de despliegue. Las ramas te permiten crear instancias separadas de tu documentación para realizar cambios, solicitar revisiones y probar nuevos enfoques antes de publicar. Tu equipo puede trabajar en ramas para actualizar distintas partes de la documentación al mismo tiempo sin afectar lo que ven los usuarios en tu sitio hasta que publiques los cambios. Recomendamos trabajar siempre con ramas al actualizar la documentación para mantener estable tu sitio en producción y habilitar flujos de revisión.
  • Pon nombres claros a las ramas para que tus compañeros entiendan en qué estás trabajando.
  • Elimina las ramas después de fusionarlas para mantener organizado tu repositorio.
  • Informa a tu equipo cuando trabajes en cambios importantes que puedan afectar su trabajo.

​
Crear una rama

  1. Selecciona el nombre de la rama en la barra de herramientas del editor (normalmente main de forma predeterminada).
  2. Selecciona New Branch.
  3. Ingresa un nombre descriptivo para tu rama, como update-getting-started o fix-api-examples.
  4. Selecciona Create Branch.

​
Guardar cambios en una rama

Para guardar tus cambios en una rama, selecciona el botón Save changes en la esquina superior derecha del editor. Esto crea un commit y envía tu trabajo a tu rama.

​
Cambiar de rama

  1. Selecciona el nombre de la rama en la barra de herramientas del editor.
  2. Selecciona la rama a la que quieres cambiar en el menú desplegable.
Los cambios no guardados se perderán al cambiar de rama. Asegúrate de guardar o publicar tu trabajo antes de cambiar de rama.