Solicitudes de incorporación de cambios

Una solicitud de incorporación de cambios (pull request) propone fusionar los cambios de una rama en otra, normalmente la rama predeterminada, y ofrece a su equipo un lugar para revisarlos, comentarlos y aprobarlos antes de que se realice la fusión.

Cree una rama a partir de la línea predeterminada, haga commit de su trabajo, abra una solicitud de incorporación de cambios para revisión y luego fusione de nuevo, como un commit de fusión, un squash o un rebase. Elimine la rama cuando termine.

Crear una rama

Trabaje en una rama nueva para que sus cambios permanezcan separados de la rama predeterminada hasta que estén listos.

En la interfaz:

1. Abra su repositorio y seleccione el selector de rama en la parte superior izquierda (muestra el nombre de la rama actual).
2. Escriba un nombre de rama nuevo en el cuadro de búsqueda y seleccione Create Branch.

De forma local:

1. Cree la rama y cámbiese a ella: git checkout -b feature-x
2. Haga sus cambios y luego prepárelos y haga commit: git add . y luego git commit -m "Describe what changed"
3. Envíe la rama a PlaidCloud Git: git push -u origin feature-x

Abrir una solicitud de incorporación de cambios

1. Abra su repositorio y seleccione la pestaña Pull Requests, y luego New Pull Request.
2. Defina la rama comparar como su rama de función y la rama base como el destino (normalmente main o master).
3. Escriba un título claro y una descripción que explique qué cambió y por qué.
4. Para vincular incidencias relacionadas, agregue una palabra clave de cierre en la descripción (por ejemplo, Closes #12) para que la incidencia se cierre automáticamente cuando se fusione la solicitud.
5. Asigne revisores si es necesario y luego seleccione Create Pull Request.

Revisar los cambios

Los revisores trabajan en la solicitud de incorporación de cambios sin fusionar nada:

1. Abra la solicitud de incorporación de cambios y seleccione Files Changed para leer las diferencias.
2. Seleccione cualquier línea de las diferencias para dejar un comentario en línea sobre ese cambio específico.
3. Al terminar, envíe un veredicto general: Aprobar para dar el visto bueno, o Request Changes para pedir primero revisiones.
4. El autor envía más commits a la misma rama para atender los comentarios: la solicitud de incorporación de cambios se actualiza automáticamente, sin necesidad de abrir una nueva.
5. Los revisores marcan los hilos de comentarios individuales como resueltos cuando se atiende cada inquietud.

Nota

Un administrador del repositorio puede habilitar la protección de ramas en la rama predeterminada para exigir un número mínimo de aprobaciones antes de que se pueda fusionar una solicitud de incorporación de cambios.

Fusionar

Una vez aprobada la solicitud de incorporación de cambios:

1. Elija un método de fusión en la lista desplegable situada junto al botón Merge:
   • Create a merge commit — conserva el historial completo de la rama mediante un commit de fusión.
   • Squash and merge — combina todos los commits de la rama en un único commit en la rama de destino.
   • Rebase and merge — reproduce los commits de la rama sobre la rama de destino sin un commit de fusión.
2. Seleccione Merge para completarla.
3. Opcionalmente, seleccione Delete Branch para limpiar la rama de función cuando ya no se necesite.

Pasos siguientes

• Trabajar con repositorios
• Dar seguimiento al trabajo con incidencias
• Organizar el trabajo con tableros de proyecto