¿Qué son las solicitudes de incorporación de cambios?

Completado

Empezamos por:

• Revisar ramas y su importancia para las solicitudes de cambios.
• Definir qué es una solicitud de cambios.
• Aprenda a crear una solicitud de incorporación de cambios, revisar los estados de la solicitud de incorporación de cambios y combinar una solicitud de incorporación de cambios.

Ramas

En primer lugar, vamos a definir qué son las ramas, por qué son importantes para los desarrolladores y cómo se relacionan con las solicitudes de cambios.

Las ramas son áreas de trabajo aisladas en las que puede desarrollar el trabajo sin afectar a otros usuarios del repositorio. Permiten desarrollar características, corregir errores y experimentar de forma segura con nuevas ideas en un área independiente del repositorio.

Trabajar en ramas independientes se ha convertido en un concepto habitual entre los desarrolladores y en el desarrollo de software moderno. Al tener su propia rama, un desarrollador puede realizar cualquier cambio, llamado confirmación, sin preocuparse de cómo afectará a otros desarrolladores que trabajan en sus propias ramas.

Combinación de ramas

Aunque hacer que cada desarrollador trabaje en una rama separada es estupendo para la productividad individual, abre un nuevo reto. En algún momento, la rama de cada desarrollador debe combinarse en una rama común, como main. A medida que los proyectos van escalando, puede haber numerosas combinaciones que deban realizarse, por lo que cada vez es más importante llevar un seguimiento de cada una de ellas y revisarlas. La necesidad de realizar un seguimiento de los múltiples cambios de un proyecto es la razón de ser de las solicitudes de cambios.

¿Qué es una solicitud de incorporación de cambios?

Una solicitud de cambios es una manera de documentar los cambios de rama y comunicar que los cambios de la rama del desarrollador están listos para combinarse en la rama base (principal). Las solicitudes de cambios brindan una oportunidad a las partes interesadas para que revisen y discutan los cambios propuestos, de cara a garantizar que la calidad del código de la rama base se mantenga lo más alta posible.

Para que se combinen las dos ramas, deben ser diferentes entre sí:

• La rama de comparación es la propia rama del desarrollador, que contiene los cambios específicos realizados.
• La rama base, también llamada rama principal, es la rama en la que se deben combinar los cambios.

El uso más común de comparar es comparar ramas, como cuando se inicia una nueva solicitud de cambios. Siempre se le lleva a la vista de comparación de ramas al iniciar una nueva solicitud de cambios.

Creación de una solicitud de incorporación de cambios

Ahora vamos a revisar cómo crear una solicitud de cambios.

1. En GitHub.com, vaya a la página principal del repositorio.

2. En el menú Rama, seleccione la rama que contiene las confirmaciones.

   

3. Encima de la lista de archivos, en el banner amarillo, seleccione el botón Comparación y solicitud de cambios para crear una solicitud de cambios para la rama asociada.

   

4. En el menú desplegable de la rama base, seleccione la rama en la que desea combinar los cambios. A continuación, seleccione el menú desplegable comparar rama para seleccionar la rama en la que realizó los cambios.

5. Escriba un título y una descripción para la solicitud de incorporación de cambios.

6. Para crear una solicitud de cambios lista para su revisión, seleccione el botón Crear solicitud de cambios. Para crear una solicitud de cambios en borrador, seleccione la lista desplegable y seleccione Crear borrador de solicitud de cambios y, a continuación, seleccione Borrador de solicitud de cambios.

Estados de la solicitud de cambios

Ahora vamos a revisar los distintos estados de una solicitud de cambios.

• Borrador de solicitud de cambios: al crear una solicitud de cambios, puede elegir crear una solicitud de cambios lista para su revisión o un borrador de solicitud de cambios. No se puede combinar una solicitud de cambios con un estado de borrador, y no se solicita automáticamente a los propietarios del código que revisen los borradores de solicitud de cambios.

• Solicitud de cambios abierta: un estado abierto significa que la solicitud de cambios está activa y aún no se ha combinado con la rama base. Todavía puede realizar confirmaciones y analizar y revisar los posibles cambios con colaboradores.

• Solicitud de cambios cerrada: puede optar por cerrar una solicitud de cambios sin combinarla en la rama base o principal. Esta opción puede ser útil si los cambios propuestos en la rama ya no son necesarios o si se propone otra solución en otra rama.

• Solicitud de cambios combinada: el estado de la solicitud de cambios combinada significa que las actualizaciones y confirmaciones de la rama de comparación se combinaron con la rama base. Cualquier persona con acceso de escritura al repositorio puede completar la fusión.

Combinar una solicitud de incorporación de cambios

1. En el nombre del repositorio, seleccione Solicitudes de cambios.

   

2. En la lista Solicitudes de cambios, seleccione la solicitud de cambios que desea combinar.

3. Desplázate hasta la parte inferior de la solicitud de incorporación de cambios. Según las opciones de fusión habilitadas para tu repositorio, puedes:

   • Combine todas las confirmaciones en la rama base seleccionando el botón Combinar solicitud de cambios. Si no se muestra la opción Combinar solicitud de cambios, seleccione el menú desplegable combinar, seleccione la opción Crear una confirmación de combinación y, a continuación, seleccione el botón Crear una confirmación de combinación.

     

   • La aplicación de squash y la fusión mediante combinación le permiten tomar todas las confirmaciones y combinarlas en una. Esta opción puede ayudarle a mantener el historial del repositorio más legible y organizado. Seleccione la opción Aplicación de squash y fusión mediante combinación y, a continuación, seleccione el botón Aplicación de squash y fusión mediante combinación.

   • La opción Fusión mediante cambio de base y fusión mediante combinación permite realizar confirmaciones sin una confirmación de combinación. Esta opción le permite omitir una combinación manteniendo un historial de proyectos lineales. Seleccione el menú desplegable de combinación y, a continuación, elija la opción Fusión mediante cambio de base y fusión mediante combinación y, a continuación, seleccione el botón Fusión mediante cambio de base y fusión mediante combinación.

4. Si se le solicita, escriba un mensaje de confirmación o acepte el mensaje predeterminado.

5. Si tiene más de una dirección de correo electrónico asociada a su cuenta en GitHub.com, seleccione el menú desplegable de dirección de correo electrónico y seleccione la dirección de correo electrónico que se usará como dirección de correo electrónico del autor de Git. Solo aparecen direcciones de correo electrónico verificadas en este menú desplegable. Si ha habilitado la privacidad de la dirección de correo electrónico, un correo electrónico de GitHub sin respuesta es la dirección de correo electrónico predeterminada del autor de la confirmación.

   

6. Seleccione Confirmar combinación, Confirmar aplicación de squash y fusión mediante combinación o Confirmar fusión mediante cambio de base y fusión mediante combinación.

7. Opcionalmente, puede eliminar la rama de comparación para mantener ordenada la lista de ramas en el repositorio.

A continuación, realice un ejercicio en el que se aplica lo aprendido a un ejemplo de la vida real.